Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Affiliate programs, deals, tracked links and product search, plus merchant program setup tools.
选择你使用的 AI 应用,然后复制设置。
通过 4/4 项检查 · 你的提问会经过开发者的服务器(partners.clickwise.net) · ✓ 命令已检查 2026年11月13日
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude · 约 2 分钟
不需要密钥,不用安装程序 · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者(Owner)添加
CustomizeConnectors
把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue
Clickwise Affiliate Networkhttps://partners.clickwise.net/api/v1/mcp在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择(Sign in now、Sign in when needed 或 No sign in),然后点击 Add
+ConnectorsClickwise Affiliate Network
用 Clickwise Affiliate Network 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 Clickwise Affiliate Network,或回答中出现 Clickwise Affiliate Network 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
能否连接 ChatGPT 取决于方案
完整 MCP:网页版 ChatGPT Business、Enterprise 或 Edu · Pro:以读取/获取权限连接,修改数据的工具可能用不了 · Plus:官方文档尚未确认,如果在插件页看到添加自定义 MCP 的选项可以试试 · 仅限网页
Plugins+Add custom MCP server
输入名称,在 Connection 下粘贴地址,勾选风险提示,然后点击 Create as a plugin
Clickwise Affiliate Networkhttps://partners.clickwise.net/api/v1/mcp开启新聊天,输入前先从插件列表中选择 Clickwise Affiliate Network
用 Clickwise Affiliate Network 告诉我你能帮我做什么,然后做一件给我看✓ 如果 ChatGPT 说正在使用 Clickwise Affiliate Network,或回答中出现 Clickwise Affiliate Network 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 OpenAI 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Claude Code · 约 2 分钟
不需要密钥,不用安装程序
Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell
claude mcp add --transport http --scope user clickwise https://partners.clickwise.net/api/v1/mcp应能看到 Clickwise Affiliate Network 在列表中并显示已连接
用 Clickwise Affiliate Network 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 Clickwise Affiliate Network,或回答中出现 Clickwise Affiliate Network 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor · 约 2 分钟
不需要密钥,不用安装程序
用 Clickwise Affiliate Network 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 Clickwise Affiliate Network,或回答中出现 Clickwise Affiliate Network 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code · 约 2 分钟
不需要密钥,不用安装程序
用 Clickwise Affiliate Network 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 Clickwise Affiliate Network,或回答中出现 Clickwise Affiliate Network 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看
通过网页连接的应用使用的地址
https://partners.clickwise.net/api/v1/mcpJSON 设置在下方“开发者专用”中
Claude Code
claude mcp add --transport http --scope user clickwise https://partners.clickwise.net/api/v1/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"clickwise": {
"url": "https://partners.clickwise.net/api/v1/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"clickwise": {
"type": "http",
"url": "https://partners.clickwise.net/api/v1/mcp"
}
}
}Authorization 机密 HTTP header说明仍为英文原文。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
通过互联网连接,适用于
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
工具名称和描述与服务器在 2026年11月14日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。
search_productsSearch fresh GTIN products in the catalog your affiliate can deliver (freshness, permissions and caps apply). Requires your affiliate API key in X-API-Key or Bearer authorization; a sandbox key (cw_sbx_, free at partners.clickwise.net/developers) also works; sandbox links are exa
get_product_feedCreate or refresh a GTIN product feed for your authenticated affiliate and one country, and return its signed URL (json, csv, tsv or xml) with Clickwise /dl/ tracked product links. The same request returns the same URL. Requires your affiliate API key. Current freshness, permissi
get_catalog_statsPublic GTIN catalog counts as of generated_at, using the same stored snapshot as /api/v1/public/catalog-stats/. Fixed one-hour validity; snapshot_stale marks older counts, served for up to 7 days. No affiliate data or amounts.
list_dealsList active Clickwise deals and offers, optionally filtered by language, category, country or merchant.
get_dealFetch the full record for a single deal by its slug. Returns title, description, code, discount, target_url, etc., in the requested language.
list_newsList Clickwise news announcements about affiliate programs (policy changes, launches, shutdowns, commission updates).
get_newsFetch the full record for a single news article by its slug.
find_affiliate_programsUse this first when someone without a Clickwise account asks which merchants to promote: it ranks live programs by fit for a described site, app, newsletter or social channel. Does not require signup. For the whole catalogue page by page use list_programs; for the programs your A
request_tracked_linksUse this when you have no Clickwise account yet and want tracked links: it creates a provisional affiliate and returns links for the programs that can issue one to it. Email is optional; the account is claimed and payout details are added later (update_profile). With an API key u
get_monetization_feedUse this when a publisher without an account wants links ready to render on a site or app: it creates a provisional Clickwise affiliate and tracked links, as request_tracked_links does, and also returns cards, an HTML embed snippet and a JSON feed. Email is optional; the account
get_tracked_link_requestFetch a link request, affiliate RefId, review status, and issued links using its access secret.
request_merchant_onboardingAlias of create_program. Create a program for its first payment. An agent calls this at a person's request. Default commission 25%, percent range 10–50%; recurring_months: 0 only. No setup fee; you pay on approved sales. The agent never accepts the Clickwise merchant terms on its
list_programsUse this to browse the whole live catalogue page by page, filtered by merchant, category or country, when find_affiliate_programs' ranked top matches are not enough. No key needed; it shows programs anyone can join. For the programs your API key is approved in use list_my_program
update_profileUpdate a creator's monetization profile (claim email, display name, website, country, payment method) using the application_id + access_secret returned by request_tracked_links. Overwrites the fields provided. Lets a creator's assistant complete claim/payout details without leavi
get_click_reportYour own native Clickwise redirect clicks for an inclusive date range. Returns individual clicks and total, excluding bots by default; upstream network clicks are not included. The REST resource has no grouping. Requires your own Clickwise affiliate API key on the MCP connection
list_my_programsUse this when you hold a Clickwise affiliate API key and need the programs that key is approved to promote, with link readiness and your existing link count; set include_available to add the ones you can apply to. For discovery without an account use find_affiliate_programs or li
create_tracking_linksUse this when you already have a Clickwise affiliate API key and want tracking links for programs you are approved in: one per item (the same program and subid return the same link), optionally deep-linking to a landing_url on the merchant's site. Each item reports its own status
get_performance_reportYour conversions and commission (what you earn), grouped by day, week, month, subid, campaign or status, for up to 366 days (default: last 30). Daily/weekly/monthly series include empty periods. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header
list_conversionsYour individual conversions (default: last 90 days) with status, commission, currency and subid, plus a per-subid rollup. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.
get_payment_statusUse this when an affiliate asks when they get paid: approved commission not yet paid (per currency and in USD), commission still pending review, the next payment as an estimate with its threshold, and the payment method as its type (a bank account shows only its last 4 digits). R
apply_to_programAsk to join a program (program_id from list_my_programs with include_available, or a campaign_id). Clickwise reviews the fit; the result is approved or pending. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts o
list_my_weekly_dealsRead the weekly deals available to your Clickwise affiliate account. Returns existing deal details only; no tracked links are created. Requires affiliate:read on your OAuth connection or your own affiliate API key.
check_storeCheck a store domain against the Clickwise catalog. Returns up to five available programs, absent, or a neutral result. Requires an affiliate OAuth connection with affiliate:read. Send a domain only, without a URL or browsing history.
create_programCreate a program for its first payment. An agent calls this at a person's request. Default commission 25%, percent range 10–50%; recurring_months: 0 only. No setup fee; you pay on approved sales. The agent never accepts the Clickwise merchant terms on its own: send terms_accepted
get_program_statusRead the application and pending question using application_id and access_secret.
answer_program_questionAnswer the application question. An agent calls this at a person's request.
get_merchant_credentialsget_merchant_credentials: Returns a merchant API token only if the account has none yet. If one exists, it answers 409 and explains where the account holder can copy it. It never reveals an existing token.
get_tracking_linkIssue a nonpayable house probe link, integration steps and a prompt for Lovable, Bolt or v0. An agent calls this at a person's request. Merchant Bearer token required.
get_conversions_keyReveal a new conversions key once, or rotate with rotate=true. An agent calls this at a person's request. Merchant Bearer token required.
get_integration_statusRead authenticated test-sale evidence and the last real sale. Merchant Bearer token required.
get_resultsRead native direct program clicks, pending, approved and rejected conversions, commission by currency and billing status. Merchant Bearer token required.
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月14日
注册名称已通过域名 clickwise.net 验证(注册中心会核实域名所有权)
代码最后更新于3天前
不适用:由 clickwise.net 的所有者自己运行的云端服务器,你不会运行仓库里的代码
在 207 毫秒内响应(HTTP 200)
无需登录
已读取 31 个工具描述,未发现针对 AI 的隐藏指令
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
还没有评价
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 4 项适用的基础检查中通过了 4 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。
它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。
GitHub 仓库最后更新于3天前,最新版本(1.8.0)于7天前进入注册中心。
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于接受远程 MCP 的应用,例如网页版 ChatGPT(Business 及以上为完整 MCP;Pro 为只读)。
同一分类中有:Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
Clickwise is an affiliate network with an API built for developers and AI agents. Search product feeds with GTINs from the networks, get product links tracked to you, find and join affiliate programs, and pull your conversions. Use it over REST, from an AI agent through MCP, or from HasOffers-compatible tools.
This repo gets you from zero to a working call: quickstarts, thin clients, MCP configs and a deployable affiliate store.
# How big is the catalog right now?
curl -s https://partners.clickwise.net/api/v1/public/catalog-stats/
curl -s "https://partners.clickwise.net/api/v1/public/catalog-sample/?country=DE"
curl -s https://partners.clickwise.net/api/v1/mcp \ -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_affiliate_programs","arguments":{"topic":"sneakers","country":"ES","channel":"site"}}}'
Request a publisher API key at [https://partners.clickwise.net/developers/](https://partners.clickwise.net/developers/). Put it in an environment variable and keep it on your server:
export CLICKWISE_API_KEY=... # never commit it, never ship it to a browser
# Who am I, what can this key do, what are my limits?
curl -s https://partners.clickwise.net/api/v1/publisher/me/ -H "X-API-Key: $CLICKWISE_API_KEY"
curl -s --get https://partners.clickwise.net/api/v1/publisher/products/lookup/ \ -H "X-API-Key: $CLICKWISE_API_KEY" \ --data-urlencode 'gtins=4006381333931,5901234123457' --data-urlencode 'country=DE'
curl -s --get https://partners.clickwise.net/api/v1/publisher/products/ \ -H "X-API-Key: $CLICKWISE_API_KEY" \ --data-urlencode 'q=sneaker' --data-urlencode 'country=GB' --data-urlencode 'limit=20'
curl -s --get https://partners.clickwise.net/api/v1/publisher/products/ \ -H "X-API-Key: $CLICKWISE_API_KEY" \ --data-urlencode 'q=smartwatch' --data-urlencode 'country=DE' --data-urlencode 'limit=20'
Each product comes back as {"gtin", "title", "price", "currency", "image", "url", "merchant", "availability", ...}. `url` is your tracked link: publish it exactly as returned.
Runnable versions of steps 1 and 3: quickstart/curl.sh · quickstart/quickstart.mjs (Node 18+) · quickstart/quickstart.py (Python 3.8+). No dependencies.
Remote MCP server (Streamable HTTP): `https://partners.clickwise.net/api/v1/mcp`, listed in the official MCP Registry as net.clickwise/mcp. The key is optional: program discovery, deals, catalog stats and provisional tracked links work without it.
# Claude Code
claude mcp add --transport http clickwise https://partners.clickwise.net/api/v1/mcp --header "X-API-Key: $CLICKWISE_API_KEY"
codex mcp add clickwise --url https://partners.clickwise.net/api/v1/mcp
gemini mcp add --transport http clickwise https://partners.clickwise.net/api/v1/mcp
/plugin marketplace add softdevfz/clickwise-api, then /plugin install clickwise@clickwise. Set CLICKWISE_API_KEY in your environment to use the tools that need a key.codex plugin marketplace add softdevfz/clickwise-api, then codex plugin add clickwise@clickwise. The key, if set, is read from CLICKWISE_API_KEY.agy plugin install https://github.com/softdevfz/clickwise-api.gemini extensions install https://github.com/softdevfz/clickwise-api. It adds the MCP server and GEMINI.md as context.SKILL.md (Claude, Codex and others): skills/clickwise-affiliate-links. Copy the folder into your agent's skills directory.Configs for Claude Code, Cursor, Claude Desktop, VS Code, ChatGPT, Grok and n8n, plus the tool list, in mcp/.
Earn commission from your AI assistant (product search, sub-IDs and signed postbacks): quickstart/monetize-agent.md.
templates/affiliate-store: a Next.js storefront that reads products by GTIN, shows live prices and publishes your tracked links. It deploys without a key in preview mode.
Building with Lovable, Bolt or v0? Paste templates/affiliate-store/PROMPT.md.
Running your own app or SaaS? Paste templates/merchant-tracking/PROMPT.md into Lovable, Bolt or v0 to add Clickwise sales tracking with Stripe, Lemon Squeezy or the conversions API.
Thin, dependency-free clients generated from the OpenAPI, one method per operation:
clients/typescript/clickwise.ts (copy one file; Node, Bun, Deno, edge).clients/python (pip install "git+https://github.com/softdevfz/clickwise-api#subdirectory=clients/python").const cw = new Clickwise(); // CLICKWISE_API_KEY
const { products } = await cw.lookupProducts({ gtins: "4006381333931", country: "DE" });
| Area | Endpoints (/api/v1/publisher/…) |
|---|---|
| Products | GET products/ search · GET products/lookup/ by id or GTIN (1–100) |
| Programs | GET programs/ · GET programs/joinable/ · POST programs/apply/ |
| Links | GET/POST links/ · POST links/batch/ (up to 50, each with its own status) |
| Reporting | GET conversions/ · GET reports/ (day, week, month, sub-ID, campaign, status) · GET clicks/ |
| Postbacks | GET postback/ · POST postback/test/ · GET postback/deliveries/ (signed HMAC webhooks) |
| Account | GET me/: access and rate limits for your key |
One error shape ({"error": {"code", "message", "status", "request_id"}}), RateLimit-* headers on every response, Retry-After on 429, Idempotency-Key on POST, X-Request-Id everywhere. Changes inside v1 are additive.
openapi/)https://partners.clickwise.net/api/v1/mcphttps://partners.clickwise.net/Apiv3/jsonrel="sponsored" on links plus a visible disclosure).Retry-After.Questions and integration help: partnerships@clickwise.net. Bugs in this repo: open an issue.
MIT. Use of the Clickwise API itself is subject to your Clickwise publisher account terms.