Clickwise Affiliate Network

net.clickwise由 clickwise.net 发布官方发布者v1.8.0更新于 Nov 7, 2026

Affiliate programs, deals, tracked links and product search, plus merchant program setup tools.

已验证Streamable HTTP可网页运行网页搜索与抓取数据与分析商业与电商

概览

AI 生成的概览

把助手接入 Clickwise 联盟网络,用于查找联盟项目、获取跟踪链接、按 GTIN 搜索商品,并读取联盟或商家数据。

可以做什么
  • 查找和浏览联盟项目、检查店铺域名、申请加入项目并列出已获批项目
  • 创建跟踪链接、在无账号时申请临时链接,并查询链接申请状态
  • 按文本或 GTIN 搜索商品、获取按国家签名的商品数据源和公开目录统计
  • 列出优惠、每周优惠和公告,并可按 slug 获取完整记录
  • 读取联盟报表:点击、转化、按周期或 subid 的佣金,以及付款状态
  • 商家工具:创建项目、回答申请问题、签发测试链接、首次显示或轮换转化密钥,并读取集成状态与业绩结果
适用场景
适合让助手推荐可推广的商家、生成联盟跟踪链接、按 GTIN 查询商品与价格,或汇总联盟账号的点击、转化和付款情况。也适用于商家搭建 Clickwise 项目并检查销售跟踪。
运行要求
远程 Streamable HTTP 端点,无需本地安装包。可选密钥:X-API-Key 联盟密钥(免费 14 天沙箱密钥可用于商品搜索和 GTIN 查询),以及商家工具所需的 Authorization 商家 Bearer 令牌。项目发现、优惠、目录统计和临时跟踪链接无需密钥。
安装前请注意
涉及两个可选密钥:X-API-Key 和商家 Authorization Bearer 令牌,应保存在服务端。多个工具会创建或修改数据:临时联盟账号与跟踪链接、资料与收款信息、项目申请、带佣金条款的项目创建,以及转化密钥轮换。商家工具可能一次性显示新的转化密钥。佣金只支付给已认领账号且仅限商家批准的销售;链接属于联盟链接,应予以披露。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Clickwise Affiliate Network,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/net.clickwise%2Fmcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "clickwise-affiliate-network": {
      "type": "http",
      "url": "https://partners.clickwise.net/api/v1/mcp"
    }
  }
}

README

Clickwise API: products by GTIN, tracked affiliate links, MCP

[MCP Registry] [OpenAPI 3.1] [License: MIT]

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.

1. First call, no key

sh
# 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 keycurl -s "https://partners.clickwise.net/api/v1/public/catalog-sample/?country=DE"
# Ask the MCP server which programs fit your sitecurl -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. Get your key

Request a publisher API key at https://partners.clickwise.net/developers/. Put it in an environment variable and keep it on your server:

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

3. First call with your key

sh
# 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 GTINscurl -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 marketcurl -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'

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.

4. Use it from an AI agent (MCP)

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.

sh
# Claude Codeclaude mcp add --transport http clickwise https://partners.clickwise.net/api/v1/mcp --header "X-API-Key: $CLICKWISE_API_KEY"
# OpenAI Codex CLIcodex mcp add clickwise --url https://partners.clickwise.net/api/v1/mcp
# Gemini CLIgemini mcp add --transport http clickwise https://partners.clickwise.net/api/v1/mcp

Plugins, extensions and skills

  • Claude Code plugin (MCP server plus the skill below): /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 (same MCP server and skill): codex plugin marketplace add softdevfz/clickwise-api, then codex plugin add clickwise@clickwise. The key, if set, is read from CLICKWISE_API_KEY.
  • Antigravity CLI plugin: agy plugin install https://github.com/softdevfz/clickwise-api.
  • Gemini CLI extension: gemini extensions install https://github.com/softdevfz/clickwise-api. It adds the MCP server and GEMINI.md as context.
  • Agent Skill for any agent that reads 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.

5. Ship an affiliate store

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.

[Deploy with Vercel] [Deploy to Netlify]

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.

WooCommerce: import the Clickwise product feed with WP All Import → guides/woocommerce/wp-all-import.md

6. Clients

Thin, dependency-free clients generated from the OpenAPI, one method per operation:

ts
const cw = new Clickwise(); // CLICKWISE_API_KEYconst { products } = await cw.lookupProducts({ gtins: "4006381333931", country: "DE" });

What the API covers

AreaEndpoints (/api/v1/publisher/…)
ProductsGET products/ search · GET products/lookup/ by id or GTIN (1–100)
ProgramsGET programs/ · GET programs/joinable/ · POST programs/apply/
LinksGET/POST links/ · POST links/batch/ (up to 50, each with its own status)
ReportingGET conversions/ · GET reports/ (day, week, month, sub-ID, campaign, status) · GET clicks/
PostbacksGET postback/ · POST postback/test/ · GET postback/deliveries/ (signed HMAC webhooks)
AccountGET 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.

Reference

Rules of the road

  • Keep the key on your server. A key acts only for its own account and never has admin access.
  • Publish product and tracking links exactly as returned, and disclose affiliate relationships (rel="sponsored" on links plus a visible disclosure).
  • Refresh prices at least every 48 hours; hide products a lookup no longer returns.
  • Honour rate limits: back off on 429 using Retry-After.

Support

Questions and integration help: [email protected]. Bugs in this repo: open an issue.

License

MIT. Use of the Clickwise API itself is subject to your Clickwise publisher account terms.

来源:README.md,提交 e1bd7eb

工具

31

search_products

Search catalog products

Search 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 examples and do not track clicks or earn commission. Every key gets exactly the REST GET /api/v1/publisher/products/ format (with gtin: /products/lookup/): products with id, gtin, title, price and currency, url (a Clickwise /dl/ tracked link created for your affiliate the first time a product is returned), image, merchant (id, name and its public website domain), availability, country, brand, category, regular_price, description, size, color and group_id (shared by the sizes of one model and colour), plus count, total and total_exact. Search by text, brand or category, or list one market by country alone; min_price and max_price filter by price in each product's own currency (inclusive, no conversion) and currency keeps one currency; with gtin every market carrying that GTIN is searched; offset paginates. Example: text "smartwatch" with country "DE" returns offers with a publisher key or a sandbox key. Add currency "EUR" to keep only euro prices.

输入参数gtintextbrandlimitsubidoffsetcountrycategorycurrencymax_pricemin_price

get_product_feed

Get product feed URL

Create 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, permissions, assignments and delivery caps apply.

输入参数formatcountry必填category

get_catalog_stats

Get catalog statistics

Public 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_deals

List deals

List active Clickwise deals and offers, optionally filtered by language, category, country or merchant.

输入参数langlimitcountrynetworkcategorymerchant

get_deal

Get deal

Fetch the full record for a single deal by its slug. Returns title, description, code, discount, target_url, etc., in the requested language.

输入参数langslug必填

list_news

List program news

List Clickwise news announcements about affiliate programs (policy changes, launches, shutdowns, commission updates).

输入参数langlimitnetworkseverity

get_news

Get news article

Fetch the full record for a single news article by its slug.

输入参数langslug必填

find_affiliate_programs

Find affiliate programs

Use 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 API key is already approved in use list_my_programs.

输入参数limittopicchannelcountrynetworkcategorymerchantpublisher_urltraffic_dailyinclude_unreadytraffic_monthly

get_monetization_feed

Get monetization feed

Use 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 is claimed later for payout. For plain links use request_tracked_links; with an existing API key use create_tracking_links.

输入参数limittopicsub_idcountrycategoryclaim_emailprogram_idspublisher_url

request_merchant_onboarding

Request merchant onboarding

Alias 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 own: send terms_accepted with terms_version only after the person has read the merchant terms page and told you they accept them. Otherwise leave it out: the program is not set up until the person accepts them and you send terms_accepted with terms_version, here or later in POST /api/v1/onboarding/merchant/{application_id}/ with the access_secret (required action confirm_terms).

输入参数langcountrymessagewebsiteverticalcommissioncookie_dayscompany_nameproduct_typecontact_emailnetworks_usedpricing_model另有 5 个

list_programs

List programs

Use 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_programs.

输入参数pagecountrynetworkcategorymerchantpage_sizeready_only

update_profile

Update creator profile

Update 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 leaving chat.

输入参数countryclaim_emailwebsite_urldisplay_nameaccess_secret必填application_id必填payment_method

get_click_report

Get click report

Your 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 (X-API-Key header or Authorization: Bearer); acts only on your account.

输入参数pagesub_iddate_todate_frompage_sizecampaign_iddeeplink_id

list_my_programs

List my programs

Use 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 list_programs. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.

输入参数pagesearchpage_sizeinclude_available

get_performance_report

Get performance report

Your 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 or Authorization: Bearer); acts only on your account.

输入参数subidstatusdate_togroup_bydate_from

list_conversions

List conversions

Your 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.

输入参数pagesubidstatusdate_todate_frompage_size

get_payment_status

Get my payment status

Use 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). Read-only; never returns account numbers, PayPal addresses, postal or tax data. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.

无需输入参数。

apply_to_program

Apply to a program

Ask 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 only on your account.

输入参数program_idcampaign_id

list_my_weekly_deals

List my weekly deals

Read 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.

输入参数lang

check_store

Check a store

Check 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.

输入参数domain必填

create_program

Create a merchant 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 own: send terms_accepted with terms_version only after the person has read the merchant terms page and told you they accept them. Otherwise leave it out: the program is not set up until the person accepts them and you send terms_accepted with terms_version, here or later in POST /api/v1/onboarding/merchant/{application_id}/ with the access_secret (required action confirm_terms).

输入参数langcountrymessagewebsiteverticalcommissioncookie_dayscompany_nameproduct_typecontact_emailnetworks_usedpricing_model另有 5 个

get_program_status

Get program status

Read the application and pending question using application_id and access_secret.

输入参数access_secret必填application_id必填

answer_program_question

Answer a program question

Answer the application question. An agent calls this at a person's request.

输入参数langmessageaccess_secret必填terms_versionapplication_id必填terms_acceptedchannel_restrictions

get_merchant_credentials

Get merchant credentials once

get_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.

输入参数access_secret必填application_id必填

get_conversions_key

Get a conversions key

Reveal a new conversions key once, or rotate with rotate=true. An agent calls this at a person's request. Merchant Bearer token required.

输入参数rotate

get_integration_status

Get integration status

Read authenticated test-sale evidence and the last real sale. Merchant Bearer token required.

无需输入参数。

get_results

Get program results

Read native direct program clicks, pending, approved and rejected conversions, commission by currency and billing status. Merchant Bearer token required.

输入参数daysgroup_by

版本历史

10
  1. v1.8.0最新Nov 7, 2026
  2. v1.7.1Oct 31, 2026
  3. v1.7.0Oct 23, 2026
  4. v1.6.3Oct 19, 2026
  5. v1.6.2Oct 13, 2026
  6. v1.6.1Oct 4, 2026
  7. v1.6.0Oct 3, 2026
  8. v1.5.1Oct 3, 2026
  9. v1.5.0Sep 30, 2026
  10. v1.4.0Sep 29, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Clickwise 集成