Skip to content
Back to search

supdropshipping-agent-skills

Agent skills and remote MCP server guide for SUP Dropshipping: ask Claude, Codex, Cursor and other AI tools about your orders, costs, tracking, inventory, wallet history, invoices and sourcing. Read-only.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lipichang--supdropshipping-agent-skills/badge.svg)](/listings/lipichang--supdropshipping-agent-skills)

HTML

<a href="/listings/lipichang--supdropshipping-agent-skills"><img src="/api/listings/lipichang--supdropshipping-agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 135 lines · 1 finding marked
  1. # SUP Dropshipping Agent Skills
  2. [English](./README.md) · [简体中文](./README.zh-CN.md) · [日本語](./README.ja.md) · [Español](./README.es.md) · [Français](./README.fr.md) · [Deutsch](./README.de.md) · [Português](./README.pt-BR.md)
  3. Agent skills for the SUP Dropshipping read-only AI API.
  4. Install this pack into a local AI coding tool (Claude Code, Codex, and others) and ask about your SUP Dropshipping account in plain language: orders, costs, tracking, connected products, private inventory, wallet history, invoices, and sourcing requests.
  5. ## Included Skills
  6. - `sup-dropshipping-ai-shared`: auth, credentials, pagination, rate limits, errors, and the request helper
  7. - `sup-dropshipping-dashboard`: account summary and connected stores
  8. - `sup-dropshipping-orders`: store orders, costs, status, tracking
  9. - `sup-dropshipping-products`: connected products and variant mapping
  10. - `sup-dropshipping-inventory`: private inventory in SUP warehouses
  11. - `sup-dropshipping-billing-logs`: wallet transaction history
  12. - `sup-dropshipping-invoices`: invoices and invoice lines
  13. - `sup-dropshipping-sourcing`: sourcing requests and replies
  14. ## What This Repository Provides
  15. - A standalone multi-skill pack
  16. - Installers for macOS, Linux, and Windows, with no `git` or `npm` requirement
  17. - A helper script that keeps your secret out of prompts and shell output
  18. - Read-only access: the API accepts `GET` requests only
  19. ## Quick Start
  20. See [QUICK_START.md](./QUICK_START.md).
  21. Short version: run the installer, restart your AI tool, ask it to "connect to my SUP Dropshipping account", click **Allow** in the browser, then ask your first question.
  22. ## MCP Server (no install)
  23. Prefer not to install anything? Add `https://www.supdropshipping.com/mcp` as a remote MCP server in Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code, Windsurf, Zed, Cline, Kiro, OpenCode or Gemini CLI, and sign in in the browser. See [MCP_GUIDE.md](./MCP_GUIDE.md).
  24. ## User Guide
  25. See [USER_GUIDE.md](./USER_GUIDE.md) for the full walkthrough: connecting your account, what you can ask, example conversations, managing the connection, and troubleshooting.
  26. ## One-Command Install
  27. macOS/Linux:
  28. ```sh
  29. curl -fsSL https://raw.githubusercontent.com/lipichang/supdropshipping-agent-skills/main/install.sh | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 46 on GitHub
  30. ```
  31. Windows PowerShell:
  32. ```powershell
  33. powershell -NoProfile -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12; & ([scriptblock]::Create((Invoke-RestMethod 'https://raw.githubusercontent.com/lipichang/supdropshipping-agent-skills/main/install.ps1')))"
  34. ```
  35. From a downloaded or unpacked copy of this repository:
  36. ```sh
  37. sh install.sh
  38. ```
  39. ```powershell
  40. powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1
  41. ```
  42. ```cmd
  43. install.cmd
  44. ```
  45. The installer detects supported AI tools under your user profile and copies every `sup-dropshipping-*` skill folder into each tool's skills directory. Existing copies are moved to `.supdropshipping-agent-skills-backups` next to the skills directory before they are replaced. Other skills are not touched.
  46. ## Options
  47. | macOS/Linux | Windows | Effect |
  48. | --- | --- | --- |
  49. | `--dry-run` | `-DryRun` | Show detected tools and planned actions without changing files |
  50. | `--ref REF` | `-Ref REF` | Install from a GitHub branch or tag (default `main`) |
  51. | `--tool KEY` | `-Tool KEY` | Install only into the given tool; may be repeated |
  52. | `--source-dir PATH` | `-SourceDir PATH` | Install from a local copy instead of GitHub |
  53. Examples:
  54. ```sh
  55. sh install.sh --dry-run
  56. sh install.sh --tool claude_code --tool codex
  57. ```
  58. ```powershell
  59. powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -DryRun
  60. powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -Tool claude_code -Tool codex
  61. ```
  62. ## Tool Support
  63. | Key | Tool | Skills directory |
  64. | --- | --- | --- |
  65. | `claude_code` | Claude Code | `~/.claude/skills` |
  66. | `codex` | Codex | `~/.codex/skills` |
  67. | `openclaw` | OpenClaw | `~/.openclaw/skills` |
  68. | `cursor` | Cursor | `~/.cursor/skills` |
  69. | `antigravity` | Antigravity | `~/.gemini/antigravity/skills` |
  70. | `opencode` | OpenCode | `~/.config/opencode/skills` |
  71. | `continue` | Continue | `~/.continue/skills` |
  72. | `gemini_cli` | Gemini CLI | `~/.gemini/skills` |
  73. | `github_copilot` | GitHub Copilot | `~/.copilot/skills` |
  74. | `qwen_code` | Qwen Code | `~/.qwen/skills` |
  75. | `windsurf` | Windsurf | `~/.codeium/windsurf/skills` |
  76. Claude Code and Codex are the primary targets. The other tools are best effort: the installer copies the skills into the directory listed above when the tool's folder exists.
  77. ## API Surface
  78. Base URL: `https://www.supdropshipping.com`
  79. | Endpoint | Skill |
  80. | --- | --- |
  81. | `GET /api/ai/v1/dashboard` | dashboard |
  82. | `GET /api/ai/v1/stores` | dashboard |
  83. | `GET /api/ai/v1/orders` | orders |
  84. | `GET /api/ai/v1/orders/{id}` | orders |
  85. | `GET /api/ai/v1/products` | products |
  86. | `GET /api/ai/v1/inventory` | inventory |
  87. | `GET /api/ai/v1/billing-logs` | billing-logs |
  88. | `GET /api/ai/v1/invoices` | invoices |
  89. | `GET /api/ai/v1/invoices/{id}` | invoices |
  90. | `GET /api/ai/v1/sourcing-requests` | sourcing |
  91. Authentication: `Authorization: Bearer <access_key_id>.<secret>`. Customers get the credential through browser sign-in (`ai_api_request.sh login`), which uses `POST /api/ai/device/code`, the approval page `/ai/authorize`, and `POST /api/ai/device/token`.
  92. ## Security Notes
  93. - The credential gives read access to your account data. Treat the saved config file like a password.
  94. - Browser sign-in shows a code in both the AI tool and the browser. Only click Allow when they match and you started the sign-in yourself.
  95. - Each account has one AI connection. A new sign-in invalidates the previous one immediately.
  96. - Credentials are stored locally in `~/.config/sup-dropshipping/ai-api.json` (macOS/Linux) or `%USERPROFILE%\.sup-dropshipping\ai-api.json` (Windows). They are not sent anywhere except to the SUP Dropshipping API.
  97. - The skills never ask for your account password.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.