Clickwise Affiliate Network

Clickwise API：按 GTIN 查找产品、跟踪联盟链接、MCP

Clickwise 是一个面向开发者和 AI Agent、提供 API 的联盟营销网络。搜索来自各网络、带有 GTIN 的产品信息流，获取跟踪到您名下的产品链接，查找并加入联盟计划，以及获取您的转化数据。您可以通过 REST、借助 MCP 从 AI Agent 调用，或通过兼容 HasOffers 的工具使用。

本仓库助您从零开始完成一次调用：包含快速入门指南、轻量客户端、MCP 配置和可部署的联盟商店。

1. 首次调用，无需密钥

# How big is the catalog right now?
curl -s https://partners.clickwise.net/api/v1/public/catalog-stats/

# Sample products in one market (DE, ES, GB, PT, SE, FR, US); no links without a key
curl -s "https://partners.clickwise.net/api/v1/public/catalog-sample/?country=DE"

# Ask the MCP server which programs fit your site
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"}}}'

2. 获取密钥

在 https://partners.clickwise.net/developers/ 申请发布商 API 密钥。将其设为环境变量，并保存在您的服务器上：

export CLICKWISE_API_KEY=...   # never commit it, never ship it to a browser

3. 使用密钥进行首次调用

# 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"

# Price, stock and YOUR tracked link for up to 100 GTINs
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'

# Search by title in one market
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'

# Same kind of search in Germany (publisher key or sandbox key)
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'

每个产品返回的数据如下：{"gtin", "title", "price", "currency", "image", "url", "merchant", "availability", ...}。url 是您的跟踪链接：请按返回内容原样发布。

步骤 1 和 3 的可运行版本：quickstart/curl.sh · quickstart/quickstart.mjs（Node 18+） · quickstart/quickstart.py（Python 3.8+）。无需依赖项。

4. 从 AI Agent 使用（MCP）

远程 MCP 服务（Streamable HTTP）：https://partners.clickwise.net/api/v1/mcp，已列入官方 MCP Registry，名称为 net.clickwise/mcp。共提供 19 个工具；密钥为可选项（无需密钥即可使用联盟计划发现、优惠和目录统计功能）。

claude mcp add --transport http clickwise https://partners.clickwise.net/api/v1/mcp --header "X-API-Key: $CLICKWISE_API_KEY"

mcp/ 中提供 Claude Code、Cursor、Claude Desktop、VS Code、ChatGPT、Grok 和 n8n 的配置，以及工具列表。

通过 AI 助手赚取佣金（产品搜索、子 ID 和签名回传）：quickstart/monetize-agent.md。

5. 部署联盟商店

templates/affiliate-store：一个 Next.js 商店前端，可按 GTIN 读取产品、显示实时价格并发布您的跟踪链接。预览模式下无需密钥即可部署。

使用 Lovable、Bolt 或 v0 构建？粘贴 templates/affiliate-store/PROMPT.md。

正在运行自己的应用或 SaaS？将 templates/merchant-tracking/PROMPT.md 粘贴到 Lovable、Bolt 或 v0，以使用 Stripe、Lemon Squeezy 或转化 API 添加 Clickwise 销售跟踪功能。

6. 客户端

由 OpenAPI 生成的轻量、无依赖客户端，每个操作对应一个方法：

• TypeScript：clients/typescript/clickwise.ts（复制单个文件；适用于 Node、Bun、Deno、边缘环境）。
• Python：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" });

API 涵盖的内容

区域	端点（/api/v1/publisher/…）
产品	GET products/ 搜索 · GET products/lookup/ 按 ID 或 GTIN 查询（1–100）
计划	GET programs/ · GET programs/joinable/ · POST programs/apply/
链接	GET/POST links/ · POST links/batch/（最多 50 个，每个都有自己的状态）
报告	GET conversions/ · GET reports/（按日、周、月、子 ID、广告系列、状态） · GET clicks/
回传	GET postback/ · POST postback/test/ · GET postback/deliveries/（经过签名的 HMAC Webhook）
账户	GET me/：此密钥的访问权限和速率限制

统一的错误格式（{"error": {"code", "message", "status", "request_id"}}），每个响应都包含 RateLimit-* 标头，429 响应包含 Retry-After，POST 请求支持 Idempotency-Key，所有响应都包含 X-Request-Id。v1 内的更改均为增量式。

参考资料

• 开发者中心：https://partners.clickwise.net/developers/
• OpenAPI 3.1：https://partners.clickwise.net/api/v1/publisher/openapi.json（快照位于 openapi/）
• Postman 集合：https://partners.clickwise.net/api/v1/publisher/postman.json
• 面向 LLM：https://partners.clickwise.net/llms.txt
• MCP：https://partners.clickwise.net/api/v1/mcp
• 兼容 HasOffers/TUNE 的联盟营销 API：https://partners.clickwise.net/Apiv3/json

使用须知

• 请将密钥保存在自己的服务器上。密钥仅对其所属账户有效，且永远没有管理员权限。
• 请按原样发布产品链接和跟踪链接，并披露联盟营销关系（链接需添加 rel="sponsored"，同时显示披露声明）。
• 至少每 48 小时刷新一次价格；隐藏查询不再返回的产品。
• 遵守速率限制：遇到 429 时，根据 Retry-After 进行退避。

支持

如有疑问或需要集成帮助，请联系：[email protected]。要报告此仓库中的错误，请创建一个议题。

许可证

MIT © SOFT DEV FZ LLC (Clickwise)。使用 Clickwise API 本身须遵守 Clickwise 发布商账户条款。