用 IntentLink 让你的 AI Agent 变现：快速上手指南

摘要

如果你正在构建 AI Agent，想要在不破坏对话体验的前提下加入原生的购物与旅行变现能力，IntentLink 提供两种接入方式 —— 一个自描述的 MCP 端点，或一个直接的 REST API。无论选择哪种方式，Agent 拿到的每一条结果都已经包含可直接使用的可跟踪购买链接 —— 不需要额外的"解析链接"步骤。本指南将结合 IntentLink 的真实 API，带你走一遍这两条接入路径。

两种接入方式

两条路径调用的是同一套底层购物与旅行搜索服务，因此结果质量没有差异。

我们的建议：优先从 MCP 开始。它的字段是经过简化的、对 Agent 更友好的子集，大多数 Agent 几分钟内就能完成接入。只有当你确实需要比 MCP 简化字段更精细的控制时，再考虑 REST。

小提示：IntentLink 的 API 目前处于活跃 beta 阶段，部分细节可能会调整 —— 最新信息请查看完整文档，遇到问题也欢迎随时联系我们。

开始之前

你需要一个已注册并激活的 agent_id —— 前往开发者页面获取。它有双重作用：既是准入密钥（未注册或未激活的 agent_id 发起的调用会被拒绝），也是归因密钥（由此产生的点击或购买都会归因给你）。

方式 A：通过 MCP 接入

MCP 被设计为自描述的 —— Agent 一旦连接成功，就可以调用 tools/list 获取可用工具、参数与使用说明，你无需为每个工具手写接入逻辑。目前提供两个工具：用于购物的 search_products，以及用于旅行（酒店、机票、套餐、机场接送、租车）的 search_travel。

从 Claude 接入（Messages API）：

{
  "model": "claude-opus-4-8",
  "max_tokens": 1024,
  "mcp_servers": [
    { "type": "url", "name": "intentlink-shopping", "url": "<YOUR_MCP_ENDPOINT>" }
  ],
  "messages": [
    { "role": "user", "content": "Find a good running shoe for my wife under $120 and give me the buy link. My agent_id is agt_your_agent_id." }
  ]
}

如果你使用的是 Claude Desktop 或 connectors 而非直接调用 API，只需将同样的端点 URL 添加为远程 MCP 服务器（Streamable HTTP）即可 —— 无需编写代码。

从 OpenAI 的 GPT 模型接入（Responses API）：

{
  "model": "gpt-5",
  "input": "Find 3 cheap wireless earbuds under $50 and give the buy link for the cheapest. agent_id agt_your_agent_id.",
  "tools": [
    { "type": "mcp", "server_label": "intentlink_shopping", "server_url": "<YOUR_MCP_ENDPOINT>", "require_approval": "never" }
  ]
}

使用通用 MCP 客户端接入（用于测试连通性）：

from mcp.client.streamable_http import streamablehttp_client
from mcp import ClientSession

async with streamablehttp_client("<YOUR_MCP_ENDPOINT>") as (r, w, _):
    async with ClientSession(r, w) as session:
        await session.initialize()
        await session.list_tools()  # self-describing: get schemas
        await session.call_tool("search_products", {
            "query": "warm winter jacket for hiking",
            "agent_id": "agt_your_agent_id"
        })

（请将 <YOUR_MCP_ENDPOINT> 替换为你开发者后台中的 MCP URL。）

方式 B：通过 REST API 接入

如果你的 Agent 不是基于 MCP 的，或者你就是想要直接的控制权，可以改为调用 REST 端点。最简请求几乎只需一行：

POST /api/v1/shopping/search
{
  "query": "a warm waterproof jacket for winter hiking",
  "caller": { "agent_id": "agt_your_agent_id" }
}

除 caller.agent_id 外，query 是唯一的必填字段 —— 其余都是可选的，只会让结果更精准。如果你想按品类缩小结果范围，还有一个 GET /api/v1/shopping/categories 端点，旅行搜索也有一套对应的端点。

你会拿到什么

无论通过 MCP 还是 REST，每条结果都会附带一个可直接使用的可跟踪购买链接（MCP 中为 buy_url，REST 中为 affiliate_url），以及常规的展示字段（标题、价格、评分、图片）。你可以把这个链接直接交给用户，不需要额外的"激活"或"解析"步骤 —— 它在搜索时就已经生成好了。作为兜底，如果某个 offer 无法生成可跟踪链接，每条结果还会附带一个未跟踪的原始商品页或目的地页链接。

写出高质量查询

以下几个技巧能显著提升结果质量：

• 把上下文放进 query，而不只是商品名称。自然语言描述的场景和人群信号 —— 比如"给我爱跑步的妻子买一份礼物""适合冬季徒步的保暖防水外套" —— 比单纯的商品词能带来更好的匹配效果。
• keywords 中使用具体词语，避免使用孤立的名词。["women running shoes"] 是一个好的关键词；["shoes"] 则不是 —— 孤立的名词可能匹配到错误人群的商品版本（比如：给"送妻子的礼物"这类查询推荐了男鞋）。
• 有意识地选择排序方式。常见场景可使用 intent 预设 —— cheapest、best_discount、top_rated 或 best_value —— 需要更精细的控制时，也可以通过显式的 ranking 维度（价格、折扣、佣金比例、评分、评论数、库存状态）自行调优。如果两者都不指定，结果默认按 best_value 排序。
• 在相关的情况下按价格、平台或库存状态筛选 —— 这些都是可选项，购物和旅行搜索均支持。

可靠性与性能

MCP 和 REST 的典型端到端搜索延迟均在 90 分位下低于 1 秒（p90 < 1s）。搜索也被设计为优雅降级而非直接失败：如果基于向量的匹配暂时不可用，会自动回退到关键词搜索；如果确实没有结果，你会收到明确的"无结果"状态而不是报错；没有有效购买链接的 offer 会被过滤掉，不会作为死链接返回给你的 Agent。

常见问题

获取你的 agent_id