REALTRACE / DEVELOPERS
MCP 接入文档
把商品、评论与社媒内容接入你的 AI 工作流。这里提供连接配置、完整工具参数与可复用的调用示例，无需登录即可阅读。
Streamable HTTPAPI Key20 个工具目录 v5.6
01 / CONNECTION
连接与鉴权
| 服务地址 | https://realtrace.cangxuandata.com/mcp |
|---|---|
| 协议 | MCP Streamable HTTP，无状态连接；每次请求携带鉴权头。 |
| 鉴权 | Authorization: Bearer <YOUR_API_KEY> |
| 获取密钥 | 登录 RealTrace → API Key 管理 → 创建 API Key。按需配置可访问平台和用量上限。 |
在支持远程 MCP 的客户端中选择 Streamable HTTP，填写服务地址与请求头。不同客户端的配置文件结构可能不同，以下是通用连接信息：
{
"url": "https://realtrace.cangxuandata.com/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}将占位符替换为自己的 API Key，并保存在客户端密钥配置中。这里不提供 OAuth 授权流程。文档页面与工具目录无需密钥，实际数据调用需要有效密钥、平台权限和可用额度。
客户端使用 MCP SDK 完成协议协商。直接实现 HTTP 客户端时，向 /mcp POST JSON-RPC，请求头包含 Content-Type: application/json 和 Accept: application/json, text/event-stream；后续请求携带协商得到的 MCP-Protocol-Version。同时支持解析 JSON 响应与 SSE 事件流中的最终响应，不要把事件流的第一条进度通知当作查询结果。
02 / QUICK START
从发现工具开始
- 连接
/mcp，发送initialize，完成notifications/initialized通知。 - 读取
tools/list，获取当前工具和参数 schema。 - 调用
get_agent_instructions(section="index")，按返回索引读取core和当前任务所需的一个业务层。 - 使用
tools/call调用数据工具，按返回的next_action继续。
下面的请求只读取调用说明，不执行付费数据查询：
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_agent_instructions","arguments":{"section":"index"}}}业务层包括 commerce、social、creators、tasks。需要更多数据时读取 more_data 和对应的 more_* 层；需要处理分页、错误或费用时读取 pagination_errors_billing。
完整参数见下方工具参考和 公开 JSON 目录。该目录是接口说明资料；执行时以同一服务实时返回的 tools/list 为准。
03 / EXAMPLES
三个数据查询示例
在 Amazon 美国站搜索商品
只有名称或关键词时先搜索，再使用结果中的 asin 查询详情或评论。Amazon 目前仅支持 www.amazon.com。
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_products","arguments":{"keyword":"wireless mouse","platform":"amazon","domain_name":"www.amazon.com","limit":5}}}在 YouTube 搜索视频
platforms 每次只包含一个平台；参数与游标放在对应平台对象内。YouTube 支持 default/all/video/shorts，不接受 sort_by。
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"search_posts","arguments":{"keyword":"smoke alarm","platforms":{"youtube":{"limit":5,"content_type":"video"}}}}}从 Target 商品读取评论
先调用 search_products，设置 platform="target"。将同轮结果里的数字 tcin 填入下面的 item_id 占位符：
{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"get_product_reviews","arguments":{"item_id":"<TCIN_FROM_SEARCH>","platform":"target","target_count":10}}}商品名、标准 ID、帖子 URL 和评论入口 ID 不能混用。TikTok Shop 使用同一区域的 product_id；Facebook / Instagram 搜索后，先把 content_url 传给 get_post_details，再使用详情确认的评论入口。X 的平台码为 twitter；LinkedIn 不支持关键词搜索。
04 / RESULTS
读取结果与续页
MCP 外层是 JSON-RPC 响应，工具返回在 result 中。按工具实际响应读取 structuredContent，或解析 content 中的 JSON 文本；同时检查 isError 和业务状态。成功数据通常包含 data、实际条数以及平台相关字段。
| 字段 | 处理方式 |
|---|---|
data | 消费实际返回的数据；字段缺失、未取满和零结果都应如实展示。 |
has_more / next_cursor | 存在后续数据时原样续传游标，不解码、不递增、不跨查询复用。 |
platform_summary | 社媒搜索的分页信息按平台读取，续传至 platforms.<platform>.cursor。 |
target_reached / completion_reason | 区分达到目标与当前查询结果集结束。请求条数是上限，不是最低保证。 |
request_id | 如响应提供，保留该标识，方便在控制台用量记录中定位查询。 |
多数列表工具每次最多交付 100 条，具体范围见工具参数。保持关键词、平台、数量、ID、筛选与排序一致；任一条件改变时，从空游标重新开始。跨平台分析由 Agent 分别调用后汇总。
05 / BACKGROUND TASKS
任务受理后，继续读取任务结果
需要多次查询的调用可能返回 response_type="background_task_acknowledgement"、data_is_final=false、task_id、progress_version 和 next_action。这时 data=[] 表示尚未交付最终数据。
- 保存
task_id与progress_version，按next_action调用get_collection_task_status。 - 后续状态请求使用最新版本作为
after_version；等待时可设置wait_seconds=20。 - 使用
get_collection_task_result读取已存结果，每页最多 100 条，原样续传结果游标。 - 暂时读空且
more_expected=true时，继续等待状态变化，再从保存的游标读取。
不要重复发起原业务请求。Amazon V2 按 ASIN+星级筛选条件分别最多获取 10 页，支持 min_rating=max_rating 的单一星级筛选，不支持多星级区间、购买验证筛选或自选排序；目标条数不保证可达。旧版本游标需清空，旧任务仅可读取已有结果，不能跨版本续跑。更多 Amazon 评论先按需读取 get_agent_instructions(section="amazon_review_expansion")，由 Agent 按 5→4→3→2→1 星分组采集并汇总。大批量商品评论可使用 start_product_review_collection；恢复已存在任务使用 resume_collection_task。任务进度轮询不等于重新查询数据，读取已持久化的结果不计费；恢复或继续执行的数据查询按实际调用计费。
06 / ERRORS & BILLING
错误处理与费用
| 情况 | 下一步 |
|---|---|
| 鉴权失败 / HTTP 401 | 检查密钥是否完整、有效，以及请求头是否为 Authorization: Bearer ...。 |
| 平台权限或额度不足 | 在控制台检查该 Key 的平台权限、用量限制、账户套餐与可用 Credits。 |
| 参数或游标无效 | 按响应的字段说明修正。过期游标需从新的查询开始，不应构造替代游标。 |
retryable=false / retry_with_same_arguments=false | 停止原样重试，执行 next_action，或补齐 required_input。 |
| 超时、限流或服务暂不可用 | 按返回的重试提示处理。已获得任务 ID 时先检查任务状态，避免重复创建查询。 |
实际查询按账户套餐与 Credits 规则计费，结果数量不直接等同于调用次数。参数预检拒绝不会发起数据查询；费用与状态以返回信息及控制台用量记录为准。查看价格，或 联系服务支持。
07 / TOOL REFERENCE
完整工具与参数
以下 20 个工具来自当前发布版本的工具目录。展开可查看参数类型、必填项、默认值与约束。嵌套对象和参数互斥规则可在“完整参数定义”中查阅。
get_agent_instructions1 个参数
按 section 分层返回 V19 下游 Agent 调用契约，每次只读取当前所需的一层，不要一次读取全部内容。首次调用 section=index；普通任务读取 core 和一个业务层，需要更多或全量数据时再读取 more_data 和对应的一个 more_* 层。逐工具参数始终以 tools/list 为准。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
section | string 可选 | 要读取的 V19 契约层。首次必须用 index；开始调用数据工具前读 core 和当前业务层。用户要求更多、100/1000 条或尽可能全量时，读 more_data 后只读对应的 more_commerce、more_social、more_creators 或 more_tasks。 默认： "index"可选： ["index", "core", "commerce", "social", "creators", "tasks", "more_data", "more_commerce", "amazon_review_expansion", "more_social", "more_creators", "more_tasks", "pagination_errors_billing"] |
完整参数定义（JSON）
{
"description": "\u6309 section \u5206\u5c42\u8fd4\u56de V19 \u4e0b\u6e38 Agent \u8c03\u7528\u5951\u7ea6\uff0c\u6bcf\u6b21\u53ea\u8bfb\u53d6\u5f53\u524d\u6240\u9700\u7684\u4e00\u5c42\uff0c\u4e0d\u8981\u4e00\u6b21\u8bfb\u53d6\u5168\u90e8\u5185\u5bb9\u3002\u9996\u6b21\u8c03\u7528 section=index\uff1b\u666e\u901a\u4efb\u52a1\u8bfb\u53d6 core \u548c\u4e00\u4e2a\u4e1a\u52a1\u5c42\uff0c\u9700\u8981\u66f4\u591a\u6216\u5168\u91cf\u6570\u636e\u65f6\u518d\u8bfb\u53d6 more_data \u548c\u5bf9\u5e94\u7684\u4e00\u4e2a more_* \u5c42\u3002\u9010\u5de5\u5177\u53c2\u6570\u59cb\u7ec8\u4ee5 tools/list \u4e3a\u51c6\u3002",
"example": {
"section": "index"
},
"name": "get_agent_instructions",
"parameters": {
"section": {
"default": "index",
"description": "\u8981\u8bfb\u53d6\u7684 V19 \u5951\u7ea6\u5c42\u3002\u9996\u6b21\u5fc5\u987b\u7528 index\uff1b\u5f00\u59cb\u8c03\u7528\u6570\u636e\u5de5\u5177\u524d\u8bfb core \u548c\u5f53\u524d\u4e1a\u52a1\u5c42\u3002\u7528\u6237\u8981\u6c42\u66f4\u591a\u3001100/1000 \u6761\u6216\u5c3d\u53ef\u80fd\u5168\u91cf\u65f6\uff0c\u8bfb more_data \u540e\u53ea\u8bfb\u5bf9\u5e94\u7684 more_commerce\u3001more_social\u3001more_creators \u6216 more_tasks\u3002",
"enum": [
"index",
"core",
"commerce",
"social",
"creators",
"tasks",
"more_data",
"more_commerce",
"amazon_review_expansion",
"more_social",
"more_creators",
"more_tasks",
"pagination_errors_billing"
],
"required": false,
"type": "string"
}
}
}search_products6 个参数
按关键词发现商品并返回后续工具所需的标准商品 ID；只有名称、品牌或描述时先调用本工具。不提供 sort_by，使用各电商上游平台默认顺序。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。 若执行计划需要多次数据查询，本工具会返回后台任务确认而非最终数据：response_type=background_task_acknowledgement、data_is_final=false、顶层 task_id/progress_version 和 next_action。此时 data=[] 绝不表示最终空结果；调用方必须执行 next_action，且不得重复原业务调用。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
keyword | string 必填 | 商品、品牌或需求关键词；不能留空。 |
platform | string 可选 | 目标电商平台；Target 后续调用使用搜索结果 TCIN，TikTok Shop 后续调用必须保持同一区域。 默认： "amazon"可选： ["amazon", "walmart", "target", "tkshop_us", "tkshop_sg", "tkshop_vn", "tkshop_id", "tkshop_th", "tkshop_my", "tkshop_ph"] |
limit | integer 可选 | 本次调用的目标返回上限，范围 1-100；服务会按需跨上游分页，但上游不足、筛选、时间或页数边界可能使结果少于该数量。 默认： 10最小值：1 · 最大值：100 |
ai_enhance | boolean 可选 | 是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。 默认： false |
cursor | string 可选 | 首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。 默认： "" |
domain_name | string 可选 | Amazon 站点域名；当前仅支持美国站 www.amazon.com；德国、日本站已停止支持。省略或传空字符串表示美国站，且必须与 URL/ID 所属站点一致。 默认： ""可选： ["", "www.amazon.com"] |
完整参数定义（JSON）
{
"description": "\u6309\u5173\u952e\u8bcd\u53d1\u73b0\u5546\u54c1\u5e76\u8fd4\u56de\u540e\u7eed\u5de5\u5177\u6240\u9700\u7684\u6807\u51c6\u5546\u54c1 ID\uff1b\u53ea\u6709\u540d\u79f0\u3001\u54c1\u724c\u6216\u63cf\u8ff0\u65f6\u5148\u8c03\u7528\u672c\u5de5\u5177\u3002\u4e0d\u63d0\u4f9b sort_by\uff0c\u4f7f\u7528\u5404\u7535\u5546\u4e0a\u6e38\u5e73\u53f0\u9ed8\u8ba4\u987a\u5e8f\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002 \u82e5\u6267\u884c\u8ba1\u5212\u9700\u8981\u591a\u6b21\u6570\u636e\u67e5\u8be2\uff0c\u672c\u5de5\u5177\u4f1a\u8fd4\u56de\u540e\u53f0\u4efb\u52a1\u786e\u8ba4\u800c\u975e\u6700\u7ec8\u6570\u636e\uff1aresponse_type=background_task_acknowledgement\u3001data_is_final=false\u3001\u9876\u5c42 task_id/progress_version \u548c next_action\u3002\u6b64\u65f6 data=[] \u7edd\u4e0d\u8868\u793a\u6700\u7ec8\u7a7a\u7ed3\u679c\uff1b\u8c03\u7528\u65b9\u5fc5\u987b\u6267\u884c next_action\uff0c\u4e14\u4e0d\u5f97\u91cd\u590d\u539f\u4e1a\u52a1\u8c03\u7528\u3002",
"example": {
"keyword": "smoke alarm",
"limit": 20,
"platform": "amazon"
},
"name": "search_products",
"parameters": {
"ai_enhance": {
"default": false,
"description": "\u662f\u5426\u5141\u8bb8\u5728\u65e0\u6cd5\u8bc6\u522b\u4e0a\u6e38\u7ed3\u6784\u65f6\u4f7f\u7528 AI \u89e3\u6790\uff1b\u901a\u5e38\u4fdd\u6301 false\u3002",
"required": false,
"type": "boolean"
},
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u5fc5\u987b\u7559\u7a7a\uff1b\u540e\u7eed\u9010\u5b57\u56de\u4f20\u540c\u4e00\u67e5\u8be2\u7684 next_cursor\uff0c\u6216\u5df2\u8bfb\u5b8c\u540e\u53f0\u4efb\u52a1\u8fd4\u56de\u7684 continuation_cursor\uff1b\u7981\u6b62\u6784\u9020\u3001\u9012\u589e\u3001\u89e3\u7801\u6216\u8de8\u67e5\u8be2\u590d\u7528\u3002",
"required": false,
"type": "string"
},
"domain_name": {
"default": "",
"description": "Amazon \u7ad9\u70b9\u57df\u540d\uff1b\u5f53\u524d\u4ec5\u652f\u6301\u7f8e\u56fd\u7ad9 www.amazon.com\uff1b\u5fb7\u56fd\u3001\u65e5\u672c\u7ad9\u5df2\u505c\u6b62\u652f\u6301\u3002\u7701\u7565\u6216\u4f20\u7a7a\u5b57\u7b26\u4e32\u8868\u793a\u7f8e\u56fd\u7ad9\uff0c\u4e14\u5fc5\u987b\u4e0e URL/ID \u6240\u5c5e\u7ad9\u70b9\u4e00\u81f4\u3002",
"enum": [
"",
"www.amazon.com"
],
"examples": [
"www.amazon.com"
],
"required": false,
"type": "string"
},
"keyword": {
"description": "\u5546\u54c1\u3001\u54c1\u724c\u6216\u9700\u6c42\u5173\u952e\u8bcd\uff1b\u4e0d\u80fd\u7559\u7a7a\u3002",
"examples": [
"Apple",
"wireless mouse"
],
"minLength": 1,
"required": true,
"type": "string"
},
"limit": {
"default": 10,
"description": "\u672c\u6b21\u8c03\u7528\u7684\u76ee\u6807\u8fd4\u56de\u4e0a\u9650\uff0c\u8303\u56f4 1-100\uff1b\u670d\u52a1\u4f1a\u6309\u9700\u8de8\u4e0a\u6e38\u5206\u9875\uff0c\u4f46\u4e0a\u6e38\u4e0d\u8db3\u3001\u7b5b\u9009\u3001\u65f6\u95f4\u6216\u9875\u6570\u8fb9\u754c\u53ef\u80fd\u4f7f\u7ed3\u679c\u5c11\u4e8e\u8be5\u6570\u91cf\u3002",
"maximum": 100,
"minimum": 1,
"required": false,
"type": "integer"
},
"platform": {
"default": "amazon",
"description": "\u76ee\u6807\u7535\u5546\u5e73\u53f0\uff1bTarget \u540e\u7eed\u8c03\u7528\u4f7f\u7528\u641c\u7d22\u7ed3\u679c TCIN\uff0cTikTok Shop \u540e\u7eed\u8c03\u7528\u5fc5\u987b\u4fdd\u6301\u540c\u4e00\u533a\u57df\u3002",
"enum": [
"amazon",
"walmart",
"target",
"tkshop_us",
"tkshop_sg",
"tkshop_vn",
"tkshop_id",
"tkshop_th",
"tkshop_my",
"tkshop_ph"
],
"required": false,
"type": "string"
}
}
}get_product_details4 个参数
通过平台标准商品 ID 获取详情；只有名称时先 search_products。Amazon 商品 URL 可自动提取 ASIN。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
item_id | string 必填 | Amazon=10 位 ASIN，Walmart=search_products 返回的数字 num_iid，Target=搜索返回的数字 TCIN，TikTok Shop=同一区域搜索返回的数字 product_id；不得传品牌名或商品标题。 |
platform | string 可选 | item_id 所属平台；必须与产生该 ID 的搜索结果一致。 默认： "amazon"可选： ["amazon", "walmart", "target", "tkshop_us", "tkshop_sg", "tkshop_vn", "tkshop_id", "tkshop_th", "tkshop_my", "tkshop_ph"] |
ai_enhance | boolean 可选 | 是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。 默认： false |
domain_name | string 可选 | Amazon 站点域名；当前仅支持美国站 www.amazon.com；德国、日本站已停止支持。省略或传空字符串表示美国站，且必须与 URL/ID 所属站点一致。 默认： ""可选： ["", "www.amazon.com"] |
完整参数定义（JSON）
{
"description": "\u901a\u8fc7\u5e73\u53f0\u6807\u51c6\u5546\u54c1 ID \u83b7\u53d6\u8be6\u60c5\uff1b\u53ea\u6709\u540d\u79f0\u65f6\u5148 search_products\u3002Amazon \u5546\u54c1 URL \u53ef\u81ea\u52a8\u63d0\u53d6 ASIN\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002",
"example": {
"item_id": "B0CJMP7WHH",
"platform": "amazon"
},
"name": "get_product_details",
"parameters": {
"ai_enhance": {
"default": false,
"description": "\u662f\u5426\u5141\u8bb8\u5728\u65e0\u6cd5\u8bc6\u522b\u4e0a\u6e38\u7ed3\u6784\u65f6\u4f7f\u7528 AI \u89e3\u6790\uff1b\u901a\u5e38\u4fdd\u6301 false\u3002",
"required": false,
"type": "boolean"
},
"domain_name": {
"default": "",
"description": "Amazon \u7ad9\u70b9\u57df\u540d\uff1b\u5f53\u524d\u4ec5\u652f\u6301\u7f8e\u56fd\u7ad9 www.amazon.com\uff1b\u5fb7\u56fd\u3001\u65e5\u672c\u7ad9\u5df2\u505c\u6b62\u652f\u6301\u3002\u7701\u7565\u6216\u4f20\u7a7a\u5b57\u7b26\u4e32\u8868\u793a\u7f8e\u56fd\u7ad9\uff0c\u4e14\u5fc5\u987b\u4e0e URL/ID \u6240\u5c5e\u7ad9\u70b9\u4e00\u81f4\u3002",
"enum": [
"",
"www.amazon.com"
],
"examples": [
"www.amazon.com"
],
"required": false,
"type": "string"
},
"item_id": {
"description": "Amazon=10 \u4f4d ASIN\uff0cWalmart=search_products \u8fd4\u56de\u7684\u6570\u5b57 num_iid\uff0cTarget=\u641c\u7d22\u8fd4\u56de\u7684\u6570\u5b57 TCIN\uff0cTikTok Shop=\u540c\u4e00\u533a\u57df\u641c\u7d22\u8fd4\u56de\u7684\u6570\u5b57 product_id\uff1b\u4e0d\u5f97\u4f20\u54c1\u724c\u540d\u6216\u5546\u54c1\u6807\u9898\u3002",
"examples": [
"B0D54JZTHY"
],
"minLength": 1,
"required": true,
"type": "string"
},
"platform": {
"default": "amazon",
"description": "item_id \u6240\u5c5e\u5e73\u53f0\uff1b\u5fc5\u987b\u4e0e\u4ea7\u751f\u8be5 ID \u7684\u641c\u7d22\u7ed3\u679c\u4e00\u81f4\u3002",
"enum": [
"amazon",
"walmart",
"target",
"tkshop_us",
"tkshop_sg",
"tkshop_vn",
"tkshop_id",
"tkshop_th",
"tkshop_my",
"tkshop_ph"
],
"required": false,
"type": "string"
}
}
}get_product_reviews11 个参数
通过单一平台的标准商品 ID 获取评论。target_count=100 表示一次业务请求希望交付 100 条，服务会在该请求内部沿同一上游游标取数；若自动转后台，只创建一次任务并查询任务状态，不得重复调用本工具。Amazon 仅美国站、默认顺序；每个 ASIN+星级筛选条件最多 10 页，支持 min_rating=max_rating，不支持多星级区间或购买验证筛选。超过 100 条、更多或尽可能全量时，先读 get_agent_instructions(section=amazon_review_expansion)。目标数量不保证可达。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。 若执行计划需要多次数据查询，本工具会返回后台任务确认而非最终数据：response_type=background_task_acknowledgement、data_is_final=false、顶层 task_id/progress_version 和 next_action。此时 data=[] 绝不表示最终空结果；调用方必须执行 next_action，且不得重复原业务调用。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
item_id | string 必填 | Amazon=10 位 ASIN；Target=search_products 返回的数字 TCIN；TikTok Shop=同一区域搜索返回的数字 product_id。不得传品牌名、标题、DPCI、Seller ID 或跨区 ID。 |
platform | string 可选 | 评论对应的平台/区域；社媒评论请改用 get_social_comments。 默认： "amazon"可选： ["amazon", "target", "tkshop_us", "tkshop_sg", "tkshop_vn", "tkshop_id", "tkshop_th", "tkshop_my", "tkshop_ph"] |
limit兼容旧版 | integer 可选 | 已废弃的取数目标别名；旧客户端仍可传 1-100。新调用请改用 target_count。 最小值：1 · 最大值：100 |
target_count | integer 可选 | 一次业务请求希望交付的评论上限，范围 1-100；不是上游页大小，也不要求下游按上游页数重复调用。服务在内部沿同一查询场景分页；达到同步预算时可能转后台或返回部分结果与 next_cursor。 最小值：1 · 最大值：100 |
ai_enhance | boolean 可选 | 是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。 默认： false |
min_rating | integer 可选 | 最低评分，1-5。Amazon 单一星级须 min_rating=max_rating；省略二者或 1..5 表示全部，不支持其他区间。其他平台保持原有能力。 默认： null最小值：1 · 最大值：5 |
max_rating | integer 可选 | 最高评分，1-5。Amazon 单一星级须 min_rating=max_rating；续页保持相同筛选。其他平台保持原有能力。 默认： null最小值：1 · 最大值：5 |
verified_only | boolean 可选 | 只返回已验证购买评论；Amazon V2 不支持，请省略或传 false。其他平台保持原有能力；缺失的验证字段不代表 false。 默认： false |
sort_by | string 可选 | 商品评论仅支持平台默认顺序，请省略或传 default；Amazon V2 不支持 hot/newest。 默认： "default"可选： ["default"] |
cursor | string 可选 | 首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。 默认： "" |
domain_name | string 可选 | Amazon 站点域名；当前仅支持美国站 www.amazon.com；德国、日本站已停止支持。省略或传空字符串表示美国站，且必须与 URL/ID 所属站点一致。 默认： ""可选： ["", "www.amazon.com"] |
完整参数定义（JSON）
{
"description": "\u901a\u8fc7\u5355\u4e00\u5e73\u53f0\u7684\u6807\u51c6\u5546\u54c1 ID \u83b7\u53d6\u8bc4\u8bba\u3002target_count=100 \u8868\u793a\u4e00\u6b21\u4e1a\u52a1\u8bf7\u6c42\u5e0c\u671b\u4ea4\u4ed8 100 \u6761\uff0c\u670d\u52a1\u4f1a\u5728\u8be5\u8bf7\u6c42\u5185\u90e8\u6cbf\u540c\u4e00\u4e0a\u6e38\u6e38\u6807\u53d6\u6570\uff1b\u82e5\u81ea\u52a8\u8f6c\u540e\u53f0\uff0c\u53ea\u521b\u5efa\u4e00\u6b21\u4efb\u52a1\u5e76\u67e5\u8be2\u4efb\u52a1\u72b6\u6001\uff0c\u4e0d\u5f97\u91cd\u590d\u8c03\u7528\u672c\u5de5\u5177\u3002Amazon \u4ec5\u7f8e\u56fd\u7ad9\u3001\u9ed8\u8ba4\u987a\u5e8f\uff1b\u6bcf\u4e2a ASIN+\u661f\u7ea7\u7b5b\u9009\u6761\u4ef6\u6700\u591a 10 \u9875\uff0c\u652f\u6301 min_rating=max_rating\uff0c\u4e0d\u652f\u6301\u591a\u661f\u7ea7\u533a\u95f4\u6216\u8d2d\u4e70\u9a8c\u8bc1\u7b5b\u9009\u3002\u8d85\u8fc7 100 \u6761\u3001\u66f4\u591a\u6216\u5c3d\u53ef\u80fd\u5168\u91cf\u65f6\uff0c\u5148\u8bfb get_agent_instructions(section=amazon_review_expansion)\u3002\u76ee\u6807\u6570\u91cf\u4e0d\u4fdd\u8bc1\u53ef\u8fbe\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002 \u82e5\u6267\u884c\u8ba1\u5212\u9700\u8981\u591a\u6b21\u6570\u636e\u67e5\u8be2\uff0c\u672c\u5de5\u5177\u4f1a\u8fd4\u56de\u540e\u53f0\u4efb\u52a1\u786e\u8ba4\u800c\u975e\u6700\u7ec8\u6570\u636e\uff1aresponse_type=background_task_acknowledgement\u3001data_is_final=false\u3001\u9876\u5c42 task_id/progress_version \u548c next_action\u3002\u6b64\u65f6 data=[] \u7edd\u4e0d\u8868\u793a\u6700\u7ec8\u7a7a\u7ed3\u679c\uff1b\u8c03\u7528\u65b9\u5fc5\u987b\u6267\u884c next_action\uff0c\u4e14\u4e0d\u5f97\u91cd\u590d\u539f\u4e1a\u52a1\u8c03\u7528\u3002",
"example": {
"item_id": "B0CJMP7WHH",
"limit": 20,
"max_rating": 1,
"min_rating": 1
},
"name": "get_product_reviews",
"parameters": {
"ai_enhance": {
"default": false,
"description": "\u662f\u5426\u5141\u8bb8\u5728\u65e0\u6cd5\u8bc6\u522b\u4e0a\u6e38\u7ed3\u6784\u65f6\u4f7f\u7528 AI \u89e3\u6790\uff1b\u901a\u5e38\u4fdd\u6301 false\u3002",
"required": false,
"type": "boolean"
},
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u5fc5\u987b\u7559\u7a7a\uff1b\u540e\u7eed\u9010\u5b57\u56de\u4f20\u540c\u4e00\u67e5\u8be2\u7684 next_cursor\uff0c\u6216\u5df2\u8bfb\u5b8c\u540e\u53f0\u4efb\u52a1\u8fd4\u56de\u7684 continuation_cursor\uff1b\u7981\u6b62\u6784\u9020\u3001\u9012\u589e\u3001\u89e3\u7801\u6216\u8de8\u67e5\u8be2\u590d\u7528\u3002",
"required": false,
"type": "string"
},
"domain_name": {
"default": "",
"description": "Amazon \u7ad9\u70b9\u57df\u540d\uff1b\u5f53\u524d\u4ec5\u652f\u6301\u7f8e\u56fd\u7ad9 www.amazon.com\uff1b\u5fb7\u56fd\u3001\u65e5\u672c\u7ad9\u5df2\u505c\u6b62\u652f\u6301\u3002\u7701\u7565\u6216\u4f20\u7a7a\u5b57\u7b26\u4e32\u8868\u793a\u7f8e\u56fd\u7ad9\uff0c\u4e14\u5fc5\u987b\u4e0e URL/ID \u6240\u5c5e\u7ad9\u70b9\u4e00\u81f4\u3002",
"enum": [
"",
"www.amazon.com"
],
"examples": [
"www.amazon.com"
],
"required": false,
"type": "string"
},
"item_id": {
"description": "Amazon=10 \u4f4d ASIN\uff1bTarget=search_products \u8fd4\u56de\u7684\u6570\u5b57 TCIN\uff1bTikTok Shop=\u540c\u4e00\u533a\u57df\u641c\u7d22\u8fd4\u56de\u7684\u6570\u5b57 product_id\u3002\u4e0d\u5f97\u4f20\u54c1\u724c\u540d\u3001\u6807\u9898\u3001DPCI\u3001Seller ID \u6216\u8de8\u533a ID\u3002",
"minLength": 1,
"required": true,
"type": "string"
},
"limit": {
"deprecated": true,
"description": "\u5df2\u5e9f\u5f03\u7684\u53d6\u6570\u76ee\u6807\u522b\u540d\uff1b\u65e7\u5ba2\u6237\u7aef\u4ecd\u53ef\u4f20 1-100\u3002\u65b0\u8c03\u7528\u8bf7\u6539\u7528 target_count\u3002",
"maximum": 100,
"minimum": 1,
"required": false,
"type": "integer"
},
"max_rating": {
"default": null,
"description": "\u6700\u9ad8\u8bc4\u5206\uff0c1-5\u3002Amazon \u5355\u4e00\u661f\u7ea7\u987b min_rating=max_rating\uff1b\u7eed\u9875\u4fdd\u6301\u76f8\u540c\u7b5b\u9009\u3002\u5176\u4ed6\u5e73\u53f0\u4fdd\u6301\u539f\u6709\u80fd\u529b\u3002",
"maximum": 5,
"minimum": 1,
"required": false,
"type": "integer"
},
"min_rating": {
"default": null,
"description": "\u6700\u4f4e\u8bc4\u5206\uff0c1-5\u3002Amazon \u5355\u4e00\u661f\u7ea7\u987b min_rating=max_rating\uff1b\u7701\u7565\u4e8c\u8005\u6216 1..5 \u8868\u793a\u5168\u90e8\uff0c\u4e0d\u652f\u6301\u5176\u4ed6\u533a\u95f4\u3002\u5176\u4ed6\u5e73\u53f0\u4fdd\u6301\u539f\u6709\u80fd\u529b\u3002",
"maximum": 5,
"minimum": 1,
"required": false,
"type": "integer"
},
"platform": {
"default": "amazon",
"description": "\u8bc4\u8bba\u5bf9\u5e94\u7684\u5e73\u53f0/\u533a\u57df\uff1b\u793e\u5a92\u8bc4\u8bba\u8bf7\u6539\u7528 get_social_comments\u3002",
"enum": [
"amazon",
"target",
"tkshop_us",
"tkshop_sg",
"tkshop_vn",
"tkshop_id",
"tkshop_th",
"tkshop_my",
"tkshop_ph"
],
"required": false,
"type": "string"
},
"sort_by": {
"default": "default",
"description": "\u5546\u54c1\u8bc4\u8bba\u4ec5\u652f\u6301\u5e73\u53f0\u9ed8\u8ba4\u987a\u5e8f\uff0c\u8bf7\u7701\u7565\u6216\u4f20 default\uff1bAmazon V2 \u4e0d\u652f\u6301 hot/newest\u3002",
"enum": [
"default"
],
"required": false,
"type": "string",
"x-realtrace-platform-capabilities": {
"amazon": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"target": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_id": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_my": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_ph": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_sg": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_th": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_us": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_vn": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
}
}
},
"target_count": {
"description": "\u4e00\u6b21\u4e1a\u52a1\u8bf7\u6c42\u5e0c\u671b\u4ea4\u4ed8\u7684\u8bc4\u8bba\u4e0a\u9650\uff0c\u8303\u56f4 1-100\uff1b\u4e0d\u662f\u4e0a\u6e38\u9875\u5927\u5c0f\uff0c\u4e5f\u4e0d\u8981\u6c42\u4e0b\u6e38\u6309\u4e0a\u6e38\u9875\u6570\u91cd\u590d\u8c03\u7528\u3002\u670d\u52a1\u5728\u5185\u90e8\u6cbf\u540c\u4e00\u67e5\u8be2\u573a\u666f\u5206\u9875\uff1b\u8fbe\u5230\u540c\u6b65\u9884\u7b97\u65f6\u53ef\u80fd\u8f6c\u540e\u53f0\u6216\u8fd4\u56de\u90e8\u5206\u7ed3\u679c\u4e0e next_cursor\u3002",
"maximum": 100,
"minimum": 1,
"required": false,
"type": "integer"
},
"verified_only": {
"default": false,
"description": "\u53ea\u8fd4\u56de\u5df2\u9a8c\u8bc1\u8d2d\u4e70\u8bc4\u8bba\uff1bAmazon V2 \u4e0d\u652f\u6301\uff0c\u8bf7\u7701\u7565\u6216\u4f20 false\u3002\u5176\u4ed6\u5e73\u53f0\u4fdd\u6301\u539f\u6709\u80fd\u529b\uff1b\u7f3a\u5931\u7684\u9a8c\u8bc1\u5b57\u6bb5\u4e0d\u4ee3\u8868 false\u3002",
"required": false,
"type": "boolean"
}
}
}get_social_comments6 个参数
通过社媒平台评论入口 ID 获取评论；Reddit 可传 sort_by=default/newest/best/top，省略时默认 newest。其他平台应省略 sort_by 并使用上游平台默认顺序。X 必须使用 platform=twitter 与数字 tweet ID；LinkedIn 使用 get_creator_posts 返回的 comment_target_id/post_id。LinkedIn/X 暂无评论回复接口。Amazon 商品评论只能使用 get_product_reviews。Facebook 和 Instagram 都必须先用搜索结果的 content_url 调 get_post_details，再使用详情返回的 comment_target_id/media_id。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。 若执行计划需要多次数据查询，本工具会返回后台任务确认而非最终数据：response_type=background_task_acknowledgement、data_is_final=false、顶层 task_id/progress_version 和 next_action。此时 data=[] 绝不表示最终空结果；调用方必须执行 next_action，且不得重复原业务调用。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
target_id | string 必填 | TikTok/YouTube=搜索返回的 video_id，Reddit=posts_id，Facebook=get_post_details 返回的 comment_target_id，Instagram=get_post_details 返回的 media_id/comment_target_id，X(platform=twitter)=数字 tweet ID，LinkedIn=get_creator_posts 返回的 comment_target_id/post_id。Amazon ASIN 请传给 get_product_reviews。 |
platform | string 必填 | target_id 所属平台；必须与产生该 ID 的前序搜索/详情结果一致。 可选： ["tiktok", "youtube", "reddit", "facebook", "instagram", "linkedin", "twitter"] |
limit | integer 可选 | 本次调用的目标返回上限，范围 1-100；服务会按需跨上游分页，但上游不足、筛选、时间或页数边界可能使结果少于该数量。 默认： 10最小值：1 · 最大值：100 |
ai_enhance | boolean 可选 | 是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。 默认： false |
sort_by | string 可选 | 仅 Reddit 可自选：传 default/newest/best/top，其中 default 等同 newest。其他平台（含 LinkedIn/X）省略 sort_by；LinkedIn 固定 relevance，X 固定 latest。旧调用显式传 default 继续兼容。 默认： "default"可选： ["default", "newest", "best", "top"] |
cursor | string 可选 | 首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。 默认： "" |
完整参数定义（JSON）
{
"description": "\u901a\u8fc7\u793e\u5a92\u5e73\u53f0\u8bc4\u8bba\u5165\u53e3 ID \u83b7\u53d6\u8bc4\u8bba\uff1bReddit \u53ef\u4f20 sort_by=default/newest/best/top\uff0c\u7701\u7565\u65f6\u9ed8\u8ba4 newest\u3002\u5176\u4ed6\u5e73\u53f0\u5e94\u7701\u7565 sort_by \u5e76\u4f7f\u7528\u4e0a\u6e38\u5e73\u53f0\u9ed8\u8ba4\u987a\u5e8f\u3002X \u5fc5\u987b\u4f7f\u7528 platform=twitter \u4e0e\u6570\u5b57 tweet ID\uff1bLinkedIn \u4f7f\u7528 get_creator_posts \u8fd4\u56de\u7684 comment_target_id/post_id\u3002LinkedIn/X \u6682\u65e0\u8bc4\u8bba\u56de\u590d\u63a5\u53e3\u3002Amazon \u5546\u54c1\u8bc4\u8bba\u53ea\u80fd\u4f7f\u7528 get_product_reviews\u3002Facebook \u548c Instagram \u90fd\u5fc5\u987b\u5148\u7528\u641c\u7d22\u7ed3\u679c\u7684 content_url \u8c03 get_post_details\uff0c\u518d\u4f7f\u7528\u8be6\u60c5\u8fd4\u56de\u7684 comment_target_id/media_id\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002 \u82e5\u6267\u884c\u8ba1\u5212\u9700\u8981\u591a\u6b21\u6570\u636e\u67e5\u8be2\uff0c\u672c\u5de5\u5177\u4f1a\u8fd4\u56de\u540e\u53f0\u4efb\u52a1\u786e\u8ba4\u800c\u975e\u6700\u7ec8\u6570\u636e\uff1aresponse_type=background_task_acknowledgement\u3001data_is_final=false\u3001\u9876\u5c42 task_id/progress_version \u548c next_action\u3002\u6b64\u65f6 data=[] \u7edd\u4e0d\u8868\u793a\u6700\u7ec8\u7a7a\u7ed3\u679c\uff1b\u8c03\u7528\u65b9\u5fc5\u987b\u6267\u884c next_action\uff0c\u4e14\u4e0d\u5f97\u91cd\u590d\u539f\u4e1a\u52a1\u8c03\u7528\u3002",
"example": {
"limit": 10,
"platform": "tiktok",
"target_id": "7123456789"
},
"name": "get_social_comments",
"parameters": {
"ai_enhance": {
"default": false,
"description": "\u662f\u5426\u5141\u8bb8\u5728\u65e0\u6cd5\u8bc6\u522b\u4e0a\u6e38\u7ed3\u6784\u65f6\u4f7f\u7528 AI \u89e3\u6790\uff1b\u901a\u5e38\u4fdd\u6301 false\u3002",
"required": false,
"type": "boolean"
},
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u5fc5\u987b\u7559\u7a7a\uff1b\u540e\u7eed\u9010\u5b57\u56de\u4f20\u540c\u4e00\u67e5\u8be2\u7684 next_cursor\uff0c\u6216\u5df2\u8bfb\u5b8c\u540e\u53f0\u4efb\u52a1\u8fd4\u56de\u7684 continuation_cursor\uff1b\u7981\u6b62\u6784\u9020\u3001\u9012\u589e\u3001\u89e3\u7801\u6216\u8de8\u67e5\u8be2\u590d\u7528\u3002",
"required": false,
"type": "string"
},
"limit": {
"default": 10,
"description": "\u672c\u6b21\u8c03\u7528\u7684\u76ee\u6807\u8fd4\u56de\u4e0a\u9650\uff0c\u8303\u56f4 1-100\uff1b\u670d\u52a1\u4f1a\u6309\u9700\u8de8\u4e0a\u6e38\u5206\u9875\uff0c\u4f46\u4e0a\u6e38\u4e0d\u8db3\u3001\u7b5b\u9009\u3001\u65f6\u95f4\u6216\u9875\u6570\u8fb9\u754c\u53ef\u80fd\u4f7f\u7ed3\u679c\u5c11\u4e8e\u8be5\u6570\u91cf\u3002",
"maximum": 100,
"minimum": 1,
"required": false,
"type": "integer"
},
"platform": {
"description": "target_id \u6240\u5c5e\u5e73\u53f0\uff1b\u5fc5\u987b\u4e0e\u4ea7\u751f\u8be5 ID \u7684\u524d\u5e8f\u641c\u7d22/\u8be6\u60c5\u7ed3\u679c\u4e00\u81f4\u3002",
"enum": [
"tiktok",
"youtube",
"reddit",
"facebook",
"instagram",
"linkedin",
"twitter"
],
"required": true,
"type": "string"
},
"sort_by": {
"default": "default",
"description": "\u4ec5 Reddit \u53ef\u81ea\u9009\uff1a\u4f20 default/newest/best/top\uff0c\u5176\u4e2d default \u7b49\u540c newest\u3002\u5176\u4ed6\u5e73\u53f0\uff08\u542b LinkedIn/X\uff09\u7701\u7565 sort_by\uff1bLinkedIn \u56fa\u5b9a relevance\uff0cX \u56fa\u5b9a latest\u3002\u65e7\u8c03\u7528\u663e\u5f0f\u4f20 default \u7ee7\u7eed\u517c\u5bb9\u3002",
"enum": [
"default",
"newest",
"best",
"top"
],
"required": false,
"type": "string",
"x-realtrace-platform-capabilities": {
"facebook": {
"accepted_values": [],
"default_order": "platform_default",
"legacy_accepted_values": [
"default"
],
"omit_when_not_selectable": true,
"selectable": false
},
"instagram": {
"accepted_values": [],
"default_order": "platform_default",
"legacy_accepted_values": [
"default"
],
"omit_when_not_selectable": true,
"selectable": false
},
"linkedin": {
"accepted_values": [],
"default_order": "relevance",
"legacy_accepted_values": [
"default"
],
"omit_when_not_selectable": true,
"selectable": false
},
"reddit": {
"accepted_values": [
"default",
"newest",
"best",
"top"
],
"default_order": "newest",
"legacy_accepted_values": [],
"omit_when_not_selectable": false,
"selectable": true
},
"tiktok": {
"accepted_values": [],
"default_order": "platform_default",
"legacy_accepted_values": [
"default"
],
"omit_when_not_selectable": true,
"selectable": false
},
"twitter": {
"accepted_values": [],
"default_order": "latest",
"legacy_accepted_values": [
"default"
],
"omit_when_not_selectable": true,
"selectable": false
},
"youtube": {
"accepted_values": [],
"default_order": "platform_default",
"legacy_accepted_values": [
"default"
],
"omit_when_not_selectable": true,
"selectable": false
}
}
},
"target_id": {
"description": "TikTok/YouTube=\u641c\u7d22\u8fd4\u56de\u7684 video_id\uff0cReddit=posts_id\uff0cFacebook=get_post_details \u8fd4\u56de\u7684 comment_target_id\uff0cInstagram=get_post_details \u8fd4\u56de\u7684 media_id/comment_target_id\uff0cX(platform=twitter)=\u6570\u5b57 tweet ID\uff0cLinkedIn=get_creator_posts \u8fd4\u56de\u7684 comment_target_id/post_id\u3002Amazon ASIN \u8bf7\u4f20\u7ed9 get_product_reviews\u3002",
"minLength": 1,
"required": true,
"type": "string"
}
}
}get_comment_replies6 个参数
获取一级评论回复；comment_id 必须来自紧邻的 get_social_comments.replyable_comment.id。不提供 sort_by，使用各社媒上游平台默认顺序。合法查询返回 0 条不计费；预检拒绝的错误参数同样不计费。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。 若执行计划需要多次数据查询，本工具会返回后台任务确认而非最终数据：response_type=background_task_acknowledgement、data_is_final=false、顶层 task_id/progress_version 和 next_action。此时 data=[] 绝不表示最终空结果；调用方必须执行 next_action，且不得重复原业务调用。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
comment_id | string 必填 | 逐字使用 get_social_comments.replyable_comment.id；Facebook 返回值已组合为 id:expansion_token，不要自行拼接。 |
platform | string 必填 | 评论所属平台。 可选： ["facebook", "reddit", "youtube"] |
limit | integer 可选 | 本次调用的目标返回上限，范围 1-100；服务会按需跨上游分页，但上游不足、筛选、时间或页数边界可能使结果少于该数量。 默认： 10最小值：1 · 最大值：100 |
ai_enhance | boolean 可选 | 是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。 默认： false |
cursor | string 可选 | 首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。 默认： "" |
video_id | string 可选 | 仅 YouTube 必填；逐字使用 get_social_comments 响应中的 video_id/target_id，其他平台留空。 默认： "" |
完整参数定义（JSON）
{
"description": "\u83b7\u53d6\u4e00\u7ea7\u8bc4\u8bba\u56de\u590d\uff1bcomment_id \u5fc5\u987b\u6765\u81ea\u7d27\u90bb\u7684 get_social_comments.replyable_comment.id\u3002\u4e0d\u63d0\u4f9b sort_by\uff0c\u4f7f\u7528\u5404\u793e\u5a92\u4e0a\u6e38\u5e73\u53f0\u9ed8\u8ba4\u987a\u5e8f\u3002\u5408\u6cd5\u67e5\u8be2\u8fd4\u56de 0 \u6761\u4e0d\u8ba1\u8d39\uff1b\u9884\u68c0\u62d2\u7edd\u7684\u9519\u8bef\u53c2\u6570\u540c\u6837\u4e0d\u8ba1\u8d39\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002 \u82e5\u6267\u884c\u8ba1\u5212\u9700\u8981\u591a\u6b21\u6570\u636e\u67e5\u8be2\uff0c\u672c\u5de5\u5177\u4f1a\u8fd4\u56de\u540e\u53f0\u4efb\u52a1\u786e\u8ba4\u800c\u975e\u6700\u7ec8\u6570\u636e\uff1aresponse_type=background_task_acknowledgement\u3001data_is_final=false\u3001\u9876\u5c42 task_id/progress_version \u548c next_action\u3002\u6b64\u65f6 data=[] \u7edd\u4e0d\u8868\u793a\u6700\u7ec8\u7a7a\u7ed3\u679c\uff1b\u8c03\u7528\u65b9\u5fc5\u987b\u6267\u884c next_action\uff0c\u4e14\u4e0d\u5f97\u91cd\u590d\u539f\u4e1a\u52a1\u8c03\u7528\u3002",
"example": {
"comment_id": "UgxCommentId",
"limit": 20,
"platform": "youtube",
"video_id": "74-dXafKB4Y"
},
"name": "get_comment_replies",
"parameters": {
"ai_enhance": {
"default": false,
"description": "\u662f\u5426\u5141\u8bb8\u5728\u65e0\u6cd5\u8bc6\u522b\u4e0a\u6e38\u7ed3\u6784\u65f6\u4f7f\u7528 AI \u89e3\u6790\uff1b\u901a\u5e38\u4fdd\u6301 false\u3002",
"required": false,
"type": "boolean"
},
"comment_id": {
"description": "\u9010\u5b57\u4f7f\u7528 get_social_comments.replyable_comment.id\uff1bFacebook \u8fd4\u56de\u503c\u5df2\u7ec4\u5408\u4e3a id:expansion_token\uff0c\u4e0d\u8981\u81ea\u884c\u62fc\u63a5\u3002",
"minLength": 1,
"required": true,
"type": "string"
},
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u5fc5\u987b\u7559\u7a7a\uff1b\u540e\u7eed\u9010\u5b57\u56de\u4f20\u540c\u4e00\u67e5\u8be2\u7684 next_cursor\uff0c\u6216\u5df2\u8bfb\u5b8c\u540e\u53f0\u4efb\u52a1\u8fd4\u56de\u7684 continuation_cursor\uff1b\u7981\u6b62\u6784\u9020\u3001\u9012\u589e\u3001\u89e3\u7801\u6216\u8de8\u67e5\u8be2\u590d\u7528\u3002",
"required": false,
"type": "string"
},
"limit": {
"default": 10,
"description": "\u672c\u6b21\u8c03\u7528\u7684\u76ee\u6807\u8fd4\u56de\u4e0a\u9650\uff0c\u8303\u56f4 1-100\uff1b\u670d\u52a1\u4f1a\u6309\u9700\u8de8\u4e0a\u6e38\u5206\u9875\uff0c\u4f46\u4e0a\u6e38\u4e0d\u8db3\u3001\u7b5b\u9009\u3001\u65f6\u95f4\u6216\u9875\u6570\u8fb9\u754c\u53ef\u80fd\u4f7f\u7ed3\u679c\u5c11\u4e8e\u8be5\u6570\u91cf\u3002",
"maximum": 100,
"minimum": 1,
"required": false,
"type": "integer"
},
"platform": {
"description": "\u8bc4\u8bba\u6240\u5c5e\u5e73\u53f0\u3002",
"enum": [
"facebook",
"reddit",
"youtube"
],
"required": true,
"type": "string"
},
"video_id": {
"default": "",
"description": "\u4ec5 YouTube \u5fc5\u586b\uff1b\u9010\u5b57\u4f7f\u7528 get_social_comments \u54cd\u5e94\u4e2d\u7684 video_id/target_id\uff0c\u5176\u4ed6\u5e73\u53f0\u7559\u7a7a\u3002",
"examples": [
"dQw4w9WgXcQ"
],
"required": false,
"required_when": {
"platform": "youtube"
},
"type": "string"
}
}
}get_shop_info3 个参数
通过店铺内一个当前可访问商品的 product_id 查询 TikTok Shop 店铺；不得传真实 seller_id、店铺名或跨区 ID。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
product_id | string 必填 | 必须来自同一区域 search_products 结果中、属于目标店铺的数字 product_id；不是 seller_id 或店铺名。 |
platform | string 可选 | 商品所在 TikTok Shop 区域，必须与 product_id 的来源一致。 默认： "tkshop_us"可选： ["tkshop_us", "tkshop_sg", "tkshop_vn", "tkshop_id", "tkshop_th", "tkshop_my", "tkshop_ph"] |
ai_enhance | boolean 可选 | 是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。 默认： false |
完整参数定义（JSON）
{
"description": "\u901a\u8fc7\u5e97\u94fa\u5185\u4e00\u4e2a\u5f53\u524d\u53ef\u8bbf\u95ee\u5546\u54c1\u7684 product_id \u67e5\u8be2 TikTok Shop \u5e97\u94fa\uff1b\u4e0d\u5f97\u4f20\u771f\u5b9e seller_id\u3001\u5e97\u94fa\u540d\u6216\u8de8\u533a ID\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002",
"example": {
"platform": "tkshop_us",
"product_id": "1730084177840870362"
},
"name": "get_shop_info",
"parameters": {
"ai_enhance": {
"default": false,
"description": "\u662f\u5426\u5141\u8bb8\u5728\u65e0\u6cd5\u8bc6\u522b\u4e0a\u6e38\u7ed3\u6784\u65f6\u4f7f\u7528 AI \u89e3\u6790\uff1b\u901a\u5e38\u4fdd\u6301 false\u3002",
"required": false,
"type": "boolean"
},
"platform": {
"default": "tkshop_us",
"description": "\u5546\u54c1\u6240\u5728 TikTok Shop \u533a\u57df\uff0c\u5fc5\u987b\u4e0e product_id \u7684\u6765\u6e90\u4e00\u81f4\u3002",
"enum": [
"tkshop_us",
"tkshop_sg",
"tkshop_vn",
"tkshop_id",
"tkshop_th",
"tkshop_my",
"tkshop_ph"
],
"required": false,
"type": "string"
},
"product_id": {
"description": "\u5fc5\u987b\u6765\u81ea\u540c\u4e00\u533a\u57df search_products \u7ed3\u679c\u4e2d\u3001\u5c5e\u4e8e\u76ee\u6807\u5e97\u94fa\u7684\u6570\u5b57 product_id\uff1b\u4e0d\u662f seller_id \u6216\u5e97\u94fa\u540d\u3002",
"minLength": 1,
"required": true,
"type": "string"
}
}
}get_rankings4 个参数
获取 Amazon BSR 分类榜；必须提供完整 Amazon Best Sellers 分类 URL，不能传类目名或裸 category_id。不提供 sort_by，按 Amazon BSR 榜单排名顺序返回。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。 若执行计划需要多次数据查询，本工具会返回后台任务确认而非最终数据：response_type=background_task_acknowledgement、data_is_final=false、顶层 task_id/progress_version 和 next_action。此时 data=[] 绝不表示最终空结果；调用方必须执行 next_action，且不得重复原业务调用。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
category_url | string 可选 | 完整 Amazon BSR/Best Sellers 分类页面 URL，需包含 amazon 站点及 /gp/bestsellers/ 或 /zgbs/ 路径。 默认： null |
limit | integer 可选 | 本次调用的目标返回上限，范围 1-100；服务会按需跨上游分页，但上游不足、筛选、时间或页数边界可能使结果少于该数量。 默认： 10最小值：1 · 最大值：100 |
ai_enhance | boolean 可选 | 是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。 默认： false |
cursor | string 可选 | 首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。 默认： "" |
完整参数定义（JSON）
{
"description": "\u83b7\u53d6 Amazon BSR \u5206\u7c7b\u699c\uff1b\u5fc5\u987b\u63d0\u4f9b\u5b8c\u6574 Amazon Best Sellers \u5206\u7c7b URL\uff0c\u4e0d\u80fd\u4f20\u7c7b\u76ee\u540d\u6216\u88f8 category_id\u3002\u4e0d\u63d0\u4f9b sort_by\uff0c\u6309 Amazon BSR \u699c\u5355\u6392\u540d\u987a\u5e8f\u8fd4\u56de\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002 \u82e5\u6267\u884c\u8ba1\u5212\u9700\u8981\u591a\u6b21\u6570\u636e\u67e5\u8be2\uff0c\u672c\u5de5\u5177\u4f1a\u8fd4\u56de\u540e\u53f0\u4efb\u52a1\u786e\u8ba4\u800c\u975e\u6700\u7ec8\u6570\u636e\uff1aresponse_type=background_task_acknowledgement\u3001data_is_final=false\u3001\u9876\u5c42 task_id/progress_version \u548c next_action\u3002\u6b64\u65f6 data=[] \u7edd\u4e0d\u8868\u793a\u6700\u7ec8\u7a7a\u7ed3\u679c\uff1b\u8c03\u7528\u65b9\u5fc5\u987b\u6267\u884c next_action\uff0c\u4e14\u4e0d\u5f97\u91cd\u590d\u539f\u4e1a\u52a1\u8c03\u7528\u3002",
"example": {
"category_url": "https://www.amazon.com/Best-Sellers-Smoke-Detectors/zgbs/hi/495270",
"limit": 30
},
"name": "get_rankings",
"parameters": {
"ai_enhance": {
"default": false,
"description": "\u662f\u5426\u5141\u8bb8\u5728\u65e0\u6cd5\u8bc6\u522b\u4e0a\u6e38\u7ed3\u6784\u65f6\u4f7f\u7528 AI \u89e3\u6790\uff1b\u901a\u5e38\u4fdd\u6301 false\u3002",
"required": false,
"type": "boolean"
},
"category_url": {
"default": null,
"description": "\u5b8c\u6574 Amazon BSR/Best Sellers \u5206\u7c7b\u9875\u9762 URL\uff0c\u9700\u5305\u542b amazon \u7ad9\u70b9\u53ca /gp/bestsellers/ \u6216 /zgbs/ \u8def\u5f84\u3002",
"examples": [
"https://www.amazon.com/gp/bestsellers/pc/13896615011"
],
"maxLength": 2048,
"minLength": 1,
"pattern": "^https://",
"required": false,
"type": "string"
},
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u5fc5\u987b\u7559\u7a7a\uff1b\u540e\u7eed\u9010\u5b57\u56de\u4f20\u540c\u4e00\u67e5\u8be2\u7684 next_cursor\uff0c\u6216\u5df2\u8bfb\u5b8c\u540e\u53f0\u4efb\u52a1\u8fd4\u56de\u7684 continuation_cursor\uff1b\u7981\u6b62\u6784\u9020\u3001\u9012\u589e\u3001\u89e3\u7801\u6216\u8de8\u67e5\u8be2\u590d\u7528\u3002",
"required": false,
"type": "string"
},
"limit": {
"default": 10,
"description": "\u672c\u6b21\u8c03\u7528\u7684\u76ee\u6807\u8fd4\u56de\u4e0a\u9650\uff0c\u8303\u56f4 1-100\uff1b\u670d\u52a1\u4f1a\u6309\u9700\u8de8\u4e0a\u6e38\u5206\u9875\uff0c\u4f46\u4e0a\u6e38\u4e0d\u8db3\u3001\u7b5b\u9009\u3001\u65f6\u95f4\u6216\u9875\u6570\u8fb9\u754c\u53ef\u80fd\u4f7f\u7ed3\u679c\u5c11\u4e8e\u8be5\u6570\u91cf\u3002",
"maximum": 100,
"minimum": 1,
"required": false,
"type": "integer"
}
}
}search_posts8 个参数
按关键词跨社媒平台发现内容。返回 social-post-search-v1 轻量记录，只包含稳定 ID、内容/作者摘要、互动指标及后续工具所需引用，不包含上游原始嵌套对象。推荐使用 platforms 对象；X 的机器码是 twitter，支持 relevance/newest。LinkedIn 不提供搜索，不能作为搜索平台。各平台分别传 limit/content_type/sort_by/cursor；任一平台参数非法时整次请求会在上游调用和计费前拒绝。旧 platform + 全局参数格式暂时兼容但已废弃，且不得与 platforms 混用。Facebook 和 Instagram 搜索列表均未经详情验证；评论前必须把 content_url 传给 get_post_details，列表 ID 不是正式评论入口。Facebook 详情失败时按 next_action 改选候选。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。 若执行计划需要多次数据查询，本工具会返回后台任务确认而非最终数据：response_type=background_task_acknowledgement、data_is_final=false、顶层 task_id/progress_version 和 next_action。此时 data=[] 绝不表示最终空结果；调用方必须执行 next_action，且不得重复原业务调用。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
keyword | string 必填 | 搜索关键词；Facebook/Instagram 建议使用单个英文词，不能留空。 |
platform兼容旧版 | string 可选 | 已废弃的兼容参数：仅允许一个平台。新调用请改用只含一个键的 platforms 对象；不得与 platforms 混用。 |
limit兼容旧版 | integer 可选 | 已废弃的兼容参数：单一平台的目标返回上限。新调用请改传 platforms.<platform>.limit。 最小值：1 · 最大值：100 |
ai_enhance | boolean 可选 | 是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。 默认： false |
content_type兼容旧版 | string 可选 | 已废弃的全局兼容参数。新调用请在每个平台对象内传其 schema 限定的 content_type；切换类型后从空 cursor 重新开始。 可选： ["default", "all", "video", "posts", "media"] |
sort_by兼容旧版 | string 可选 | 已废弃的全局兼容参数。新调用仅在 platforms.facebook 或 platforms.twitter 的 sort_by 传各自 schema 枚举；YouTube、TikTok、Reddit、Instagram 不接受该字段。 可选： ["relevance", "newest", "rating", "viewCount"] |
cursor兼容旧版 | string 可选 | 已废弃的全局兼容续页参数。新调用请逐字回传 platforms.<platform>.cursor，值来自 platform_summary.<platform>.next_cursor。 |
platforms | object 可选 | 推荐格式。每次只能出现一个平台键；跨平台分析请由 Agent 分别调用后汇总。未传字段使用该平台默认值，非法参数会在调用上游和计费前拒绝。 |
完整参数定义（JSON）
{
"description": "\u6309\u5173\u952e\u8bcd\u8de8\u793e\u5a92\u5e73\u53f0\u53d1\u73b0\u5185\u5bb9\u3002\u8fd4\u56de social-post-search-v1 \u8f7b\u91cf\u8bb0\u5f55\uff0c\u53ea\u5305\u542b\u7a33\u5b9a ID\u3001\u5185\u5bb9/\u4f5c\u8005\u6458\u8981\u3001\u4e92\u52a8\u6307\u6807\u53ca\u540e\u7eed\u5de5\u5177\u6240\u9700\u5f15\u7528\uff0c\u4e0d\u5305\u542b\u4e0a\u6e38\u539f\u59cb\u5d4c\u5957\u5bf9\u8c61\u3002\u63a8\u8350\u4f7f\u7528 platforms \u5bf9\u8c61\uff1bX \u7684\u673a\u5668\u7801\u662f twitter\uff0c\u652f\u6301 relevance/newest\u3002LinkedIn \u4e0d\u63d0\u4f9b\u641c\u7d22\uff0c\u4e0d\u80fd\u4f5c\u4e3a\u641c\u7d22\u5e73\u53f0\u3002\u5404\u5e73\u53f0\u5206\u522b\u4f20 limit/content_type/sort_by/cursor\uff1b\u4efb\u4e00\u5e73\u53f0\u53c2\u6570\u975e\u6cd5\u65f6\u6574\u6b21\u8bf7\u6c42\u4f1a\u5728\u4e0a\u6e38\u8c03\u7528\u548c\u8ba1\u8d39\u524d\u62d2\u7edd\u3002\u65e7 platform + \u5168\u5c40\u53c2\u6570\u683c\u5f0f\u6682\u65f6\u517c\u5bb9\u4f46\u5df2\u5e9f\u5f03\uff0c\u4e14\u4e0d\u5f97\u4e0e platforms \u6df7\u7528\u3002Facebook \u548c Instagram \u641c\u7d22\u5217\u8868\u5747\u672a\u7ecf\u8be6\u60c5\u9a8c\u8bc1\uff1b\u8bc4\u8bba\u524d\u5fc5\u987b\u628a content_url \u4f20\u7ed9 get_post_details\uff0c\u5217\u8868 ID \u4e0d\u662f\u6b63\u5f0f\u8bc4\u8bba\u5165\u53e3\u3002Facebook \u8be6\u60c5\u5931\u8d25\u65f6\u6309 next_action \u6539\u9009\u5019\u9009\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002 \u82e5\u6267\u884c\u8ba1\u5212\u9700\u8981\u591a\u6b21\u6570\u636e\u67e5\u8be2\uff0c\u672c\u5de5\u5177\u4f1a\u8fd4\u56de\u540e\u53f0\u4efb\u52a1\u786e\u8ba4\u800c\u975e\u6700\u7ec8\u6570\u636e\uff1aresponse_type=background_task_acknowledgement\u3001data_is_final=false\u3001\u9876\u5c42 task_id/progress_version \u548c next_action\u3002\u6b64\u65f6 data=[] \u7edd\u4e0d\u8868\u793a\u6700\u7ec8\u7a7a\u7ed3\u679c\uff1b\u8c03\u7528\u65b9\u5fc5\u987b\u6267\u884c next_action\uff0c\u4e14\u4e0d\u5f97\u91cd\u590d\u539f\u4e1a\u52a1\u8c03\u7528\u3002",
"example": {
"keyword": "fire safety home",
"platforms": {
"youtube": {
"limit": 10,
"sort_by": "newest"
}
}
},
"input_constraints": {
"oneOf": [
{
"not": {
"anyOf": [
{
"required": [
"platform"
]
},
{
"required": [
"limit"
]
},
{
"required": [
"content_type"
]
},
{
"required": [
"sort_by"
]
},
{
"required": [
"cursor"
]
}
]
},
"required": [
"platforms"
],
"title": "platform-scoped format"
},
{
"not": {
"required": [
"platforms"
]
},
"required": [
"platform"
],
"title": "deprecated legacy format"
}
],
"x-realtrace-request-formats": {
"legacy": [
"platform",
"limit",
"content_type",
"sort_by",
"cursor"
],
"mixing_allowed": false,
"preferred": "platforms"
}
},
"name": "search_posts",
"parameters": {
"ai_enhance": {
"default": false,
"description": "\u662f\u5426\u5141\u8bb8\u5728\u65e0\u6cd5\u8bc6\u522b\u4e0a\u6e38\u7ed3\u6784\u65f6\u4f7f\u7528 AI \u89e3\u6790\uff1b\u901a\u5e38\u4fdd\u6301 false\u3002",
"required": false,
"type": "boolean"
},
"content_type": {
"deprecated": true,
"description": "\u5df2\u5e9f\u5f03\u7684\u5168\u5c40\u517c\u5bb9\u53c2\u6570\u3002\u65b0\u8c03\u7528\u8bf7\u5728\u6bcf\u4e2a\u5e73\u53f0\u5bf9\u8c61\u5185\u4f20\u5176 schema \u9650\u5b9a\u7684 content_type\uff1b\u5207\u6362\u7c7b\u578b\u540e\u4ece\u7a7a cursor \u91cd\u65b0\u5f00\u59cb\u3002",
"enum": [
"default",
"all",
"video",
"posts",
"media"
],
"required": false,
"type": "string"
},
"cursor": {
"deprecated": true,
"description": "\u5df2\u5e9f\u5f03\u7684\u5168\u5c40\u517c\u5bb9\u7eed\u9875\u53c2\u6570\u3002\u65b0\u8c03\u7528\u8bf7\u9010\u5b57\u56de\u4f20 platforms.\u003cplatform\u003e.cursor\uff0c\u503c\u6765\u81ea platform_summary.\u003cplatform\u003e.next_cursor\u3002",
"required": false,
"type": "string"
},
"keyword": {
"description": "\u641c\u7d22\u5173\u952e\u8bcd\uff1bFacebook/Instagram \u5efa\u8bae\u4f7f\u7528\u5355\u4e2a\u82f1\u6587\u8bcd\uff0c\u4e0d\u80fd\u7559\u7a7a\u3002",
"examples": [
"apple",
"home safety"
],
"maxLength": 200,
"minLength": 1,
"required": true,
"type": "string"
},
"limit": {
"deprecated": true,
"description": "\u5df2\u5e9f\u5f03\u7684\u517c\u5bb9\u53c2\u6570\uff1a\u5355\u4e00\u5e73\u53f0\u7684\u76ee\u6807\u8fd4\u56de\u4e0a\u9650\u3002\u65b0\u8c03\u7528\u8bf7\u6539\u4f20 platforms.\u003cplatform\u003e.limit\u3002",
"maximum": 100,
"minimum": 1,
"required": false,
"type": "integer"
},
"platform": {
"deprecated": true,
"description": "\u5df2\u5e9f\u5f03\u7684\u517c\u5bb9\u53c2\u6570\uff1a\u4ec5\u5141\u8bb8\u4e00\u4e2a\u5e73\u53f0\u3002\u65b0\u8c03\u7528\u8bf7\u6539\u7528\u53ea\u542b\u4e00\u4e2a\u952e\u7684 platforms \u5bf9\u8c61\uff1b\u4e0d\u5f97\u4e0e platforms \u6df7\u7528\u3002",
"examples": [
"youtube"
],
"maxLength": 80,
"minLength": 1,
"pattern": "^(?:tiktok|youtube|reddit|facebook|instagram|twitter)$",
"required": false,
"type": "string"
},
"platforms": {
"additionalProperties": false,
"description": "\u63a8\u8350\u683c\u5f0f\u3002\u6bcf\u6b21\u53ea\u80fd\u51fa\u73b0\u4e00\u4e2a\u5e73\u53f0\u952e\uff1b\u8de8\u5e73\u53f0\u5206\u6790\u8bf7\u7531 Agent \u5206\u522b\u8c03\u7528\u540e\u6c47\u603b\u3002\u672a\u4f20\u5b57\u6bb5\u4f7f\u7528\u8be5\u5e73\u53f0\u9ed8\u8ba4\u503c\uff0c\u975e\u6cd5\u53c2\u6570\u4f1a\u5728\u8c03\u7528\u4e0a\u6e38\u548c\u8ba1\u8d39\u524d\u62d2\u7edd\u3002",
"examples": [
{
"facebook": {
"content_type": "all",
"limit": 50,
"sort_by": "newest"
}
}
],
"maxProperties": 1,
"minProperties": 1,
"properties": {
"facebook": {
"additionalProperties": false,
"description": "\u9009\u62e9 facebook \u5e76\u914d\u7f6e\u8be5\u5e73\u53f0\u81ea\u5df1\u7684\u641c\u7d22\u53c2\u6570\u3002",
"properties": {
"content_type": {
"default": "default",
"description": "\u4ec5\u53ef\u4f7f\u7528\u8be5\u5e73\u53f0\u58f0\u660e\u7684\u5185\u5bb9\u7c7b\u578b\uff1b\u7701\u7565\u65f6\u4f7f\u7528\u5e73\u53f0\u9ed8\u8ba4\u7c7b\u578b\u3002",
"enum": [
"default",
"video",
"all"
],
"type": "string"
},
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u7701\u7565\uff1b\u7eed\u9875\u65f6\u9010\u5b57\u56de\u4f20\u8be5\u5e73\u53f0\u4e0a\u4e00\u6b21\u54cd\u5e94\u4e2d\u7684 platform_summary.\u003cplatform\u003e.next_cursor\u3002",
"type": "string"
},
"limit": {
"default": 10,
"description": "\u8be5\u5e73\u53f0\u7684\u76ee\u6807\u8fd4\u56de\u4e0a\u9650\uff1b\u7701\u7565\u65f6\u9ed8\u8ba4 10\u3002",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"sort_by": {
"default": "relevance",
"description": "\u8be5\u5e73\u53f0\u7684\u6392\u5e8f\u65b9\u5f0f\uff1b\u7701\u7565\u65f6\u4f7f\u7528\u58f0\u660e\u7684\u9ed8\u8ba4\u503c\u3002",
"enum": [
"relevance",
"newest"
],
"type": "string"
}
},
"type": "object"
},
"instagram": {
"additionalProperties": false,
"description": "\u9009\u62e9 instagram \u5e76\u914d\u7f6e\u8be5\u5e73\u53f0\u81ea\u5df1\u7684\u641c\u7d22\u53c2\u6570\u3002",
"properties": {
"content_type": {
"default": "default",
"description": "\u4ec5\u53ef\u4f7f\u7528\u8be5\u5e73\u53f0\u58f0\u660e\u7684\u5185\u5bb9\u7c7b\u578b\uff1b\u7701\u7565\u65f6\u4f7f\u7528\u5e73\u53f0\u9ed8\u8ba4\u7c7b\u578b\u3002",
"enum": [
"default",
"posts"
],
"type": "string"
},
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u7701\u7565\uff1b\u7eed\u9875\u65f6\u9010\u5b57\u56de\u4f20\u8be5\u5e73\u53f0\u4e0a\u4e00\u6b21\u54cd\u5e94\u4e2d\u7684 platform_summary.\u003cplatform\u003e.next_cursor\u3002",
"type": "string"
},
"limit": {
"default": 10,
"description": "\u8be5\u5e73\u53f0\u7684\u76ee\u6807\u8fd4\u56de\u4e0a\u9650\uff1b\u7701\u7565\u65f6\u9ed8\u8ba4 10\u3002",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"reddit": {
"additionalProperties": false,
"description": "\u9009\u62e9 reddit \u5e76\u914d\u7f6e\u8be5\u5e73\u53f0\u81ea\u5df1\u7684\u641c\u7d22\u53c2\u6570\u3002",
"properties": {
"content_type": {
"default": "default",
"description": "\u4ec5\u53ef\u4f7f\u7528\u8be5\u5e73\u53f0\u58f0\u660e\u7684\u5185\u5bb9\u7c7b\u578b\uff1b\u7701\u7565\u65f6\u4f7f\u7528\u5e73\u53f0\u9ed8\u8ba4\u7c7b\u578b\u3002",
"enum": [
"default",
"posts",
"media"
],
"type": "string"
},
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u7701\u7565\uff1b\u7eed\u9875\u65f6\u9010\u5b57\u56de\u4f20\u8be5\u5e73\u53f0\u4e0a\u4e00\u6b21\u54cd\u5e94\u4e2d\u7684 platform_summary.\u003cplatform\u003e.next_cursor\u3002",
"type": "string"
},
"limit": {
"default": 10,
"description": "\u8be5\u5e73\u53f0\u7684\u76ee\u6807\u8fd4\u56de\u4e0a\u9650\uff1b\u7701\u7565\u65f6\u9ed8\u8ba4 10\u3002",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"tiktok": {
"additionalProperties": false,
"description": "\u9009\u62e9 tiktok \u5e76\u914d\u7f6e\u8be5\u5e73\u53f0\u81ea\u5df1\u7684\u641c\u7d22\u53c2\u6570\u3002",
"properties": {
"content_type": {
"default": "default",
"description": "\u4ec5\u53ef\u4f7f\u7528\u8be5\u5e73\u53f0\u58f0\u660e\u7684\u5185\u5bb9\u7c7b\u578b\uff1b\u7701\u7565\u65f6\u4f7f\u7528\u5e73\u53f0\u9ed8\u8ba4\u7c7b\u578b\u3002",
"enum": [
"default",
"video"
],
"type": "string"
},
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u7701\u7565\uff1b\u7eed\u9875\u65f6\u9010\u5b57\u56de\u4f20\u8be5\u5e73\u53f0\u4e0a\u4e00\u6b21\u54cd\u5e94\u4e2d\u7684 platform_summary.\u003cplatform\u003e.next_cursor\u3002",
"type": "string"
},
"limit": {
"default": 10,
"description": "\u8be5\u5e73\u53f0\u7684\u76ee\u6807\u8fd4\u56de\u4e0a\u9650\uff1b\u7701\u7565\u65f6\u9ed8\u8ba4 10\u3002",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"twitter": {
"additionalProperties": false,
"description": "\u9009\u62e9 twitter \u5e76\u914d\u7f6e\u8be5\u5e73\u53f0\u81ea\u5df1\u7684\u641c\u7d22\u53c2\u6570\u3002",
"properties": {
"content_type": {
"default": "default",
"description": "\u4ec5\u53ef\u4f7f\u7528\u8be5\u5e73\u53f0\u58f0\u660e\u7684\u5185\u5bb9\u7c7b\u578b\uff1b\u7701\u7565\u65f6\u4f7f\u7528\u5e73\u53f0\u9ed8\u8ba4\u7c7b\u578b\u3002",
"enum": [
"default",
"posts"
],
"type": "string"
},
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u7701\u7565\uff1b\u7eed\u9875\u65f6\u9010\u5b57\u56de\u4f20\u8be5\u5e73\u53f0\u4e0a\u4e00\u6b21\u54cd\u5e94\u4e2d\u7684 platform_summary.\u003cplatform\u003e.next_cursor\u3002",
"type": "string"
},
"limit": {
"default": 10,
"description": "\u8be5\u5e73\u53f0\u7684\u76ee\u6807\u8fd4\u56de\u4e0a\u9650\uff1b\u7701\u7565\u65f6\u9ed8\u8ba4 10\u3002",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"sort_by": {
"default": "relevance",
"description": "\u8be5\u5e73\u53f0\u7684\u6392\u5e8f\u65b9\u5f0f\uff1b\u7701\u7565\u65f6\u4f7f\u7528\u58f0\u660e\u7684\u9ed8\u8ba4\u503c\u3002",
"enum": [
"relevance",
"newest"
],
"type": "string"
}
},
"type": "object"
},
"youtube": {
"additionalProperties": false,
"description": "\u9009\u62e9 youtube \u5e76\u914d\u7f6e\u8be5\u5e73\u53f0\u81ea\u5df1\u7684\u641c\u7d22\u53c2\u6570\u3002",
"properties": {
"content_type": {
"default": "default",
"description": "\u4ec5\u53ef\u4f7f\u7528\u8be5\u5e73\u53f0\u58f0\u660e\u7684\u5185\u5bb9\u7c7b\u578b\uff1b\u7701\u7565\u65f6\u4f7f\u7528\u5e73\u53f0\u9ed8\u8ba4\u7c7b\u578b\u3002",
"enum": [
"default",
"all",
"video",
"shorts"
],
"type": "string"
},
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u7701\u7565\uff1b\u7eed\u9875\u65f6\u9010\u5b57\u56de\u4f20\u8be5\u5e73\u53f0\u4e0a\u4e00\u6b21\u54cd\u5e94\u4e2d\u7684 platform_summary.\u003cplatform\u003e.next_cursor\u3002",
"type": "string"
},
"limit": {
"default": 10,
"description": "\u8be5\u5e73\u53f0\u7684\u76ee\u6807\u8fd4\u56de\u4e0a\u9650\uff1b\u7701\u7565\u65f6\u9ed8\u8ba4 10\u3002",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
}
},
"required": false,
"type": "object"
},
"sort_by": {
"deprecated": true,
"description": "\u5df2\u5e9f\u5f03\u7684\u5168\u5c40\u517c\u5bb9\u53c2\u6570\u3002\u65b0\u8c03\u7528\u4ec5\u5728 platforms.facebook \u6216 platforms.twitter \u7684 sort_by \u4f20\u5404\u81ea schema \u679a\u4e3e\uff1bYouTube\u3001TikTok\u3001Reddit\u3001Instagram \u4e0d\u63a5\u53d7\u8be5\u5b57\u6bb5\u3002",
"enum": [
"relevance",
"newest",
"rating",
"viewCount"
],
"required": false,
"type": "string",
"x-realtrace-platform-capabilities": {
"facebook": {
"accepted_values": [
"relevance",
"newest"
],
"default_order": "relevance",
"legacy_accepted_values": [],
"omit_when_not_selectable": false,
"selectable": true
},
"instagram": {
"accepted_values": [],
"default_order": "platform_default",
"legacy_accepted_values": [
"relevance"
],
"omit_when_not_selectable": true,
"selectable": false
},
"reddit": {
"accepted_values": [],
"default_order": "platform_default",
"legacy_accepted_values": [
"relevance"
],
"omit_when_not_selectable": true,
"selectable": false
},
"tiktok": {
"accepted_values": [],
"default_order": "newest",
"legacy_accepted_values": [
"relevance",
"newest"
],
"omit_when_not_selectable": true,
"selectable": false
},
"twitter": {
"accepted_values": [
"relevance",
"newest"
],
"default_order": "relevance",
"legacy_accepted_values": [],
"omit_when_not_selectable": false,
"selectable": true
},
"youtube": {
"accepted_values": [],
"default_order": "platform_default",
"legacy_accepted_values": [],
"omit_when_not_selectable": true,
"selectable": false
}
}
}
}
}get_post_details3 个参数
通过平台内容 URL 获取帖子/视频详情；Instagram 使用 search_posts 返回的 content_url，并由详情返回评论所需的 media_id/comment_target_id；Facebook 详情返回评论所需的 comment_target_id，候选无法解析时 next_action 会要求改选另一个搜索结果。TikTok、YouTube、Reddit 也接受可验证的裸内容 ID。只有关键词时先 search_posts。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
url | string 必填 | 目标平台的帖子/视频 URL；YouTube 可传 11 位 video_id，TikTok 可传数字 video_id，Reddit 可传 posts_id。不得传标题或关键词。 |
platform | string 必填 | URL/内容 ID 所属平台。 可选： ["reddit", "tiktok", "facebook", "instagram", "youtube"] |
ai_enhance | boolean 可选 | 是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。 默认： false |
完整参数定义（JSON）
{
"description": "\u901a\u8fc7\u5e73\u53f0\u5185\u5bb9 URL \u83b7\u53d6\u5e16\u5b50/\u89c6\u9891\u8be6\u60c5\uff1bInstagram \u4f7f\u7528 search_posts \u8fd4\u56de\u7684 content_url\uff0c\u5e76\u7531\u8be6\u60c5\u8fd4\u56de\u8bc4\u8bba\u6240\u9700\u7684 media_id/comment_target_id\uff1bFacebook \u8be6\u60c5\u8fd4\u56de\u8bc4\u8bba\u6240\u9700\u7684 comment_target_id\uff0c\u5019\u9009\u65e0\u6cd5\u89e3\u6790\u65f6 next_action \u4f1a\u8981\u6c42\u6539\u9009\u53e6\u4e00\u4e2a\u641c\u7d22\u7ed3\u679c\u3002TikTok\u3001YouTube\u3001Reddit \u4e5f\u63a5\u53d7\u53ef\u9a8c\u8bc1\u7684\u88f8\u5185\u5bb9 ID\u3002\u53ea\u6709\u5173\u952e\u8bcd\u65f6\u5148 search_posts\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002",
"example": {
"platform": "reddit",
"url": "https://www.reddit.com/r/Home/comments/abc123"
},
"name": "get_post_details",
"parameters": {
"ai_enhance": {
"default": false,
"description": "\u662f\u5426\u5141\u8bb8\u5728\u65e0\u6cd5\u8bc6\u522b\u4e0a\u6e38\u7ed3\u6784\u65f6\u4f7f\u7528 AI \u89e3\u6790\uff1b\u901a\u5e38\u4fdd\u6301 false\u3002",
"required": false,
"type": "boolean"
},
"platform": {
"description": "URL/\u5185\u5bb9 ID \u6240\u5c5e\u5e73\u53f0\u3002",
"enum": [
"reddit",
"tiktok",
"facebook",
"instagram",
"youtube"
],
"required": true,
"type": "string"
},
"url": {
"description": "\u76ee\u6807\u5e73\u53f0\u7684\u5e16\u5b50/\u89c6\u9891 URL\uff1bYouTube \u53ef\u4f20 11 \u4f4d video_id\uff0cTikTok \u53ef\u4f20\u6570\u5b57 video_id\uff0cReddit \u53ef\u4f20 posts_id\u3002\u4e0d\u5f97\u4f20\u6807\u9898\u6216\u5173\u952e\u8bcd\u3002",
"maxLength": 2048,
"minLength": 1,
"required": true,
"type": "string"
}
}
}get_creator_info3 个参数
通过平台标准账号 ID 获取创作者信息；X 使用 platform=twitter 与数字 Rest ID；LinkedIn 使用 /in/ 后的 username，也可传完整 linkedin.com/in/... URL并自动提取。显示名和关键词不能代替稳定 ID。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
creator_id | string 必填 | TikTok/Instagram=search_posts 返回的数字 user_id；YouTube=channel_id；Reddit=帖子详情 author 用户名；Facebook=主页 URL；X(platform=twitter)=数字 Rest ID；LinkedIn=/in/ 后的 username 或完整 profile URL。 |
platform | string 必填 | creator_id 所属平台。 可选： ["tiktok", "youtube", "reddit", "facebook", "instagram", "linkedin", "twitter"] |
ai_enhance | boolean 可选 | 是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。 默认： false |
完整参数定义（JSON）
{
"description": "\u901a\u8fc7\u5e73\u53f0\u6807\u51c6\u8d26\u53f7 ID \u83b7\u53d6\u521b\u4f5c\u8005\u4fe1\u606f\uff1bX \u4f7f\u7528 platform=twitter \u4e0e\u6570\u5b57 Rest ID\uff1bLinkedIn \u4f7f\u7528 /in/ \u540e\u7684 username\uff0c\u4e5f\u53ef\u4f20\u5b8c\u6574 linkedin.com/in/... URL\u5e76\u81ea\u52a8\u63d0\u53d6\u3002\u663e\u793a\u540d\u548c\u5173\u952e\u8bcd\u4e0d\u80fd\u4ee3\u66ff\u7a33\u5b9a ID\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002",
"example": {
"creator_id": "username",
"platform": "tiktok"
},
"name": "get_creator_info",
"parameters": {
"ai_enhance": {
"default": false,
"description": "\u662f\u5426\u5141\u8bb8\u5728\u65e0\u6cd5\u8bc6\u522b\u4e0a\u6e38\u7ed3\u6784\u65f6\u4f7f\u7528 AI \u89e3\u6790\uff1b\u901a\u5e38\u4fdd\u6301 false\u3002",
"required": false,
"type": "boolean"
},
"creator_id": {
"description": "TikTok/Instagram=search_posts \u8fd4\u56de\u7684\u6570\u5b57 user_id\uff1bYouTube=channel_id\uff1bReddit=\u5e16\u5b50\u8be6\u60c5 author \u7528\u6237\u540d\uff1bFacebook=\u4e3b\u9875 URL\uff1bX(platform=twitter)=\u6570\u5b57 Rest ID\uff1bLinkedIn=/in/ \u540e\u7684 username \u6216\u5b8c\u6574 profile URL\u3002",
"minLength": 1,
"required": true,
"type": "string"
},
"platform": {
"description": "creator_id \u6240\u5c5e\u5e73\u53f0\u3002",
"enum": [
"tiktok",
"youtube",
"reddit",
"facebook",
"instagram",
"linkedin",
"twitter"
],
"required": true,
"type": "string"
}
}
}get_creator_posts7 个参数
通过平台标准账号 ID 获取账号内容；支持 TikTok、YouTube、Facebook、Instagram、LinkedIn 与 X。TikTok 使用 search_posts 或 get_creator_info 返回的 sec_uid；X 使用 platform=twitter 与数字 Rest ID；LinkedIn 需要 /in/ username 和匹配的完整 profile URL。LinkedIn/X 只返回发布的 posts，不提供 sort_by，使用上游平台默认顺序。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。 若执行计划需要多次数据查询，本工具会返回后台任务确认而非最终数据：response_type=background_task_acknowledgement、data_is_final=false、顶层 task_id/progress_version 和 next_action。此时 data=[] 绝不表示最终空结果；调用方必须执行 next_action，且不得重复原业务调用。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
platform | string 必填 | 账号平台；X 必须写 twitter；Reddit 当前没有账号内容上游能力。 可选： ["tiktok", "youtube", "facebook", "instagram", "linkedin", "twitter"] |
account_id | string 必填 | TikTok=search_posts 或 get_creator_info 返回的 sec_uid；YouTube=channel_id；Facebook=数字 owner/page ID；Instagram=数字 user_id；X=数字 Rest ID；LinkedIn=/in/ 后的 username。不得传 @handle、显示名或关键词。 |
account_url | string 可选 | Facebook 和 LinkedIn 必填：分别传与 account_id 匹配的 facebook.com 主页 URL 或完整 https://www.linkedin.com/in/<username> URL；其他平台留空。 默认： "" |
limit | integer 可选 | 本次调用的目标返回上限，范围 1-100；服务会按需跨上游分页，但上游不足、筛选、时间或页数边界可能使结果少于该数量。 默认： 10最小值：1 · 最大值：100 |
cursor | string 可选 | 首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。 默认： "" |
content_type | string 可选 | 仅 Facebook 可选 video/photos；其他平台保持默认 video。Instagram、LinkedIn、X 的实际返回 content_type 为 post。 默认： "video"可选： ["video", "photos"] |
ai_enhance | boolean 可选 | 是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。 默认： false |
完整参数定义（JSON）
{
"description": "\u901a\u8fc7\u5e73\u53f0\u6807\u51c6\u8d26\u53f7 ID \u83b7\u53d6\u8d26\u53f7\u5185\u5bb9\uff1b\u652f\u6301 TikTok\u3001YouTube\u3001Facebook\u3001Instagram\u3001LinkedIn \u4e0e X\u3002TikTok \u4f7f\u7528 search_posts \u6216 get_creator_info \u8fd4\u56de\u7684 sec_uid\uff1bX \u4f7f\u7528 platform=twitter \u4e0e\u6570\u5b57 Rest ID\uff1bLinkedIn \u9700\u8981 /in/ username \u548c\u5339\u914d\u7684\u5b8c\u6574 profile URL\u3002LinkedIn/X \u53ea\u8fd4\u56de\u53d1\u5e03\u7684 posts\uff0c\u4e0d\u63d0\u4f9b sort_by\uff0c\u4f7f\u7528\u4e0a\u6e38\u5e73\u53f0\u9ed8\u8ba4\u987a\u5e8f\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002 \u82e5\u6267\u884c\u8ba1\u5212\u9700\u8981\u591a\u6b21\u6570\u636e\u67e5\u8be2\uff0c\u672c\u5de5\u5177\u4f1a\u8fd4\u56de\u540e\u53f0\u4efb\u52a1\u786e\u8ba4\u800c\u975e\u6700\u7ec8\u6570\u636e\uff1aresponse_type=background_task_acknowledgement\u3001data_is_final=false\u3001\u9876\u5c42 task_id/progress_version \u548c next_action\u3002\u6b64\u65f6 data=[] \u7edd\u4e0d\u8868\u793a\u6700\u7ec8\u7a7a\u7ed3\u679c\uff1b\u8c03\u7528\u65b9\u5fc5\u987b\u6267\u884c next_action\uff0c\u4e14\u4e0d\u5f97\u91cd\u590d\u539f\u4e1a\u52a1\u8c03\u7528\u3002",
"example": {
"account_id": "UCxxxxxxxxxxxxxxxxxxxxxx",
"limit": 10,
"platform": "youtube"
},
"name": "get_creator_posts",
"parameters": {
"account_id": {
"description": "TikTok=search_posts \u6216 get_creator_info \u8fd4\u56de\u7684 sec_uid\uff1bYouTube=channel_id\uff1bFacebook=\u6570\u5b57 owner/page ID\uff1bInstagram=\u6570\u5b57 user_id\uff1bX=\u6570\u5b57 Rest ID\uff1bLinkedIn=/in/ \u540e\u7684 username\u3002\u4e0d\u5f97\u4f20 @handle\u3001\u663e\u793a\u540d\u6216\u5173\u952e\u8bcd\u3002",
"minLength": 1,
"required": true,
"type": "string"
},
"account_url": {
"default": "",
"description": "Facebook \u548c LinkedIn \u5fc5\u586b\uff1a\u5206\u522b\u4f20\u4e0e account_id \u5339\u914d\u7684 facebook.com \u4e3b\u9875 URL \u6216\u5b8c\u6574 https://www.linkedin.com/in/\u003cusername\u003e URL\uff1b\u5176\u4ed6\u5e73\u53f0\u7559\u7a7a\u3002",
"required": false,
"type": "string"
},
"ai_enhance": {
"default": false,
"description": "\u662f\u5426\u5141\u8bb8\u5728\u65e0\u6cd5\u8bc6\u522b\u4e0a\u6e38\u7ed3\u6784\u65f6\u4f7f\u7528 AI \u89e3\u6790\uff1b\u901a\u5e38\u4fdd\u6301 false\u3002",
"required": false,
"type": "boolean"
},
"content_type": {
"default": "video",
"description": "\u4ec5 Facebook \u53ef\u9009 video/photos\uff1b\u5176\u4ed6\u5e73\u53f0\u4fdd\u6301\u9ed8\u8ba4 video\u3002Instagram\u3001LinkedIn\u3001X \u7684\u5b9e\u9645\u8fd4\u56de content_type \u4e3a post\u3002",
"enum": [
"video",
"photos"
],
"required": false,
"type": "string"
},
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u5fc5\u987b\u7559\u7a7a\uff1b\u540e\u7eed\u9010\u5b57\u56de\u4f20\u540c\u4e00\u67e5\u8be2\u7684 next_cursor\uff0c\u6216\u5df2\u8bfb\u5b8c\u540e\u53f0\u4efb\u52a1\u8fd4\u56de\u7684 continuation_cursor\uff1b\u7981\u6b62\u6784\u9020\u3001\u9012\u589e\u3001\u89e3\u7801\u6216\u8de8\u67e5\u8be2\u590d\u7528\u3002",
"required": false,
"type": "string"
},
"limit": {
"default": 10,
"description": "\u672c\u6b21\u8c03\u7528\u7684\u76ee\u6807\u8fd4\u56de\u4e0a\u9650\uff0c\u8303\u56f4 1-100\uff1b\u670d\u52a1\u4f1a\u6309\u9700\u8de8\u4e0a\u6e38\u5206\u9875\uff0c\u4f46\u4e0a\u6e38\u4e0d\u8db3\u3001\u7b5b\u9009\u3001\u65f6\u95f4\u6216\u9875\u6570\u8fb9\u754c\u53ef\u80fd\u4f7f\u7ed3\u679c\u5c11\u4e8e\u8be5\u6570\u91cf\u3002",
"maximum": 100,
"minimum": 1,
"required": false,
"type": "integer"
},
"platform": {
"description": "\u8d26\u53f7\u5e73\u53f0\uff1bX \u5fc5\u987b\u5199 twitter\uff1bReddit \u5f53\u524d\u6ca1\u6709\u8d26\u53f7\u5185\u5bb9\u4e0a\u6e38\u80fd\u529b\u3002",
"enum": [
"tiktok",
"youtube",
"facebook",
"instagram",
"linkedin",
"twitter"
],
"required": true,
"type": "string"
}
}
}get_captions3 个参数
获取 YouTube 字幕；必须提供 YouTube 视频 URL 或 11 位 video_id，只有标题/关键词时先 search_posts。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
video_url | string 必填 | YouTube watch/shorts/embed/youtu.be URL，或 11 位 video_id；不得传标题、关键词或频道 ID。 |
platform | string 可选 | 当前仅支持 youtube。 默认： "youtube"可选： ["youtube"] |
ai_enhance | boolean 可选 | 是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。 默认： false |
完整参数定义（JSON）
{
"description": "\u83b7\u53d6 YouTube \u5b57\u5e55\uff1b\u5fc5\u987b\u63d0\u4f9b YouTube \u89c6\u9891 URL \u6216 11 \u4f4d video_id\uff0c\u53ea\u6709\u6807\u9898/\u5173\u952e\u8bcd\u65f6\u5148 search_posts\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002",
"example": {
"platform": "youtube",
"video_url": "https://www.youtube.com/watch?v=74-dXafKB4Y"
},
"name": "get_captions",
"parameters": {
"ai_enhance": {
"default": false,
"description": "\u662f\u5426\u5141\u8bb8\u5728\u65e0\u6cd5\u8bc6\u522b\u4e0a\u6e38\u7ed3\u6784\u65f6\u4f7f\u7528 AI \u89e3\u6790\uff1b\u901a\u5e38\u4fdd\u6301 false\u3002",
"required": false,
"type": "boolean"
},
"platform": {
"default": "youtube",
"description": "\u5f53\u524d\u4ec5\u652f\u6301 youtube\u3002",
"enum": [
"youtube"
],
"required": false,
"type": "string"
},
"video_url": {
"description": "YouTube watch/shorts/embed/youtu.be URL\uff0c\u6216 11 \u4f4d video_id\uff1b\u4e0d\u5f97\u4f20\u6807\u9898\u3001\u5173\u952e\u8bcd\u6216\u9891\u9053 ID\u3002",
"examples": [
"https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"dQw4w9WgXcQ"
],
"minLength": 1,
"required": true,
"type": "string"
}
}
}get_brandshop_products7 个参数
通过已知 Amazon Store page UUID 获取品牌店商品；品牌名不能作为 brandshop_id。不提供 sort_by，使用 Amazon Store 上游默认顺序。enrich=false 只查列表；enrich=true 会为每个返回 ASIN 额外发起详情查询，有详情数据才计费，空详情不计费。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。 若执行计划需要多次数据查询，本工具会返回后台任务确认而非最终数据：response_type=background_task_acknowledgement、data_is_final=false、顶层 task_id/progress_version 和 next_action。此时 data=[] 绝不表示最终空结果；调用方必须执行 next_action，且不得重复原业务调用。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
brandshop_id | string 必填 | Amazon Store 页面 /page/ 后的 UUID，或包含该 UUID 的完整 Amazon Store URL。绝不能传 Apple 等品牌名、ASIN 或 Seller ID。 |
keyword | string 可选 | 可选的店铺内商品筛选词；不是品牌店名称解析参数。 默认： "" |
limit | integer 可选 | 本次调用的目标返回上限，范围 1-100；服务会按需跨上游分页，但上游不足、筛选、时间或页数边界可能使结果少于该数量。 默认： 10最小值：1 · 最大值：100 |
ai_enhance | boolean 可选 | 是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。 默认： false |
enrich | boolean 可选 | 高成本开关。false 仅查列表；true 对每个返回 ASIN 再做一次详情查询。每次实际返回并用于交付的列表或详情查询基础价为 1 Credit；空详情不计费。因此 limit=3,enrich=true 最多为 1 次列表 + 3 次有数据详情 = 4 基础 Credits（活动折扣另计）。 默认： false |
domain_name | string 可选 | Amazon 站点域名；当前仅支持美国站 www.amazon.com；德国、日本站已停止支持。省略或传空字符串表示美国站，且必须与 URL/ID 所属站点一致。 默认： ""可选： ["", "www.amazon.com"] |
cursor | string 可选 | 首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。 默认： "" |
完整参数定义（JSON）
{
"description": "\u901a\u8fc7\u5df2\u77e5 Amazon Store page UUID \u83b7\u53d6\u54c1\u724c\u5e97\u5546\u54c1\uff1b\u54c1\u724c\u540d\u4e0d\u80fd\u4f5c\u4e3a brandshop_id\u3002\u4e0d\u63d0\u4f9b sort_by\uff0c\u4f7f\u7528 Amazon Store \u4e0a\u6e38\u9ed8\u8ba4\u987a\u5e8f\u3002enrich=false \u53ea\u67e5\u5217\u8868\uff1benrich=true \u4f1a\u4e3a\u6bcf\u4e2a\u8fd4\u56de ASIN \u989d\u5916\u53d1\u8d77\u8be6\u60c5\u67e5\u8be2\uff0c\u6709\u8be6\u60c5\u6570\u636e\u624d\u8ba1\u8d39\uff0c\u7a7a\u8be6\u60c5\u4e0d\u8ba1\u8d39\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002 \u82e5\u6267\u884c\u8ba1\u5212\u9700\u8981\u591a\u6b21\u6570\u636e\u67e5\u8be2\uff0c\u672c\u5de5\u5177\u4f1a\u8fd4\u56de\u540e\u53f0\u4efb\u52a1\u786e\u8ba4\u800c\u975e\u6700\u7ec8\u6570\u636e\uff1aresponse_type=background_task_acknowledgement\u3001data_is_final=false\u3001\u9876\u5c42 task_id/progress_version \u548c next_action\u3002\u6b64\u65f6 data=[] \u7edd\u4e0d\u8868\u793a\u6700\u7ec8\u7a7a\u7ed3\u679c\uff1b\u8c03\u7528\u65b9\u5fc5\u987b\u6267\u884c next_action\uff0c\u4e14\u4e0d\u5f97\u91cd\u590d\u539f\u4e1a\u52a1\u8c03\u7528\u3002",
"example": {
"brandshop_id": "F2EA1BDC-1CBB-45F8-A05E-EF75A20B8A50",
"enrich": true,
"limit": 5
},
"name": "get_brandshop_products",
"parameters": {
"ai_enhance": {
"default": false,
"description": "\u662f\u5426\u5141\u8bb8\u5728\u65e0\u6cd5\u8bc6\u522b\u4e0a\u6e38\u7ed3\u6784\u65f6\u4f7f\u7528 AI \u89e3\u6790\uff1b\u901a\u5e38\u4fdd\u6301 false\u3002",
"required": false,
"type": "boolean"
},
"brandshop_id": {
"description": "Amazon Store \u9875\u9762 /page/ \u540e\u7684 UUID\uff0c\u6216\u5305\u542b\u8be5 UUID \u7684\u5b8c\u6574 Amazon Store URL\u3002\u7edd\u4e0d\u80fd\u4f20 Apple \u7b49\u54c1\u724c\u540d\u3001ASIN \u6216 Seller ID\u3002",
"examples": [
"F2EA1BDC-1CBB-45F8-A05E-EF75A20B8A50"
],
"minLength": 1,
"required": true,
"type": "string"
},
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u5fc5\u987b\u7559\u7a7a\uff1b\u540e\u7eed\u9010\u5b57\u56de\u4f20\u540c\u4e00\u67e5\u8be2\u7684 next_cursor\uff0c\u6216\u5df2\u8bfb\u5b8c\u540e\u53f0\u4efb\u52a1\u8fd4\u56de\u7684 continuation_cursor\uff1b\u7981\u6b62\u6784\u9020\u3001\u9012\u589e\u3001\u89e3\u7801\u6216\u8de8\u67e5\u8be2\u590d\u7528\u3002",
"required": false,
"type": "string"
},
"domain_name": {
"default": "",
"description": "Amazon \u7ad9\u70b9\u57df\u540d\uff1b\u5f53\u524d\u4ec5\u652f\u6301\u7f8e\u56fd\u7ad9 www.amazon.com\uff1b\u5fb7\u56fd\u3001\u65e5\u672c\u7ad9\u5df2\u505c\u6b62\u652f\u6301\u3002\u7701\u7565\u6216\u4f20\u7a7a\u5b57\u7b26\u4e32\u8868\u793a\u7f8e\u56fd\u7ad9\uff0c\u4e14\u5fc5\u987b\u4e0e URL/ID \u6240\u5c5e\u7ad9\u70b9\u4e00\u81f4\u3002",
"enum": [
"",
"www.amazon.com"
],
"examples": [
"www.amazon.com"
],
"required": false,
"type": "string"
},
"enrich": {
"default": false,
"description": "\u9ad8\u6210\u672c\u5f00\u5173\u3002false \u4ec5\u67e5\u5217\u8868\uff1btrue \u5bf9\u6bcf\u4e2a\u8fd4\u56de ASIN \u518d\u505a\u4e00\u6b21\u8be6\u60c5\u67e5\u8be2\u3002\u6bcf\u6b21\u5b9e\u9645\u8fd4\u56de\u5e76\u7528\u4e8e\u4ea4\u4ed8\u7684\u5217\u8868\u6216\u8be6\u60c5\u67e5\u8be2\u57fa\u7840\u4ef7\u4e3a 1 Credit\uff1b\u7a7a\u8be6\u60c5\u4e0d\u8ba1\u8d39\u3002\u56e0\u6b64 limit=3,enrich=true \u6700\u591a\u4e3a 1 \u6b21\u5217\u8868 + 3 \u6b21\u6709\u6570\u636e\u8be6\u60c5 = 4 \u57fa\u7840 Credits\uff08\u6d3b\u52a8\u6298\u6263\u53e6\u8ba1\uff09\u3002",
"required": false,
"type": "boolean"
},
"keyword": {
"default": "",
"description": "\u53ef\u9009\u7684\u5e97\u94fa\u5185\u5546\u54c1\u7b5b\u9009\u8bcd\uff1b\u4e0d\u662f\u54c1\u724c\u5e97\u540d\u79f0\u89e3\u6790\u53c2\u6570\u3002",
"required": false,
"type": "string"
},
"limit": {
"default": 10,
"description": "\u672c\u6b21\u8c03\u7528\u7684\u76ee\u6807\u8fd4\u56de\u4e0a\u9650\uff0c\u8303\u56f4 1-100\uff1b\u670d\u52a1\u4f1a\u6309\u9700\u8de8\u4e0a\u6e38\u5206\u9875\uff0c\u4f46\u4e0a\u6e38\u4e0d\u8db3\u3001\u7b5b\u9009\u3001\u65f6\u95f4\u6216\u9875\u6570\u8fb9\u754c\u53ef\u80fd\u4f7f\u7ed3\u679c\u5c11\u4e8e\u8be5\u6570\u91cf\u3002",
"maximum": 100,
"minimum": 1,
"required": false,
"type": "integer"
}
}
}start_product_review_collection11 个参数
启动单一平台的商品评论后台采集。Amazon 每个 ASIN+星级筛选条件最多 10 页，单个任务不会自动切换星级；扩展采集先读 amazon_review_expansion 层。任务断线后继续并逐批 checkpoint；相同参数自动复用。响应返回动态 capacity。若当前已有不同任务，默认返回 decision_required，并同时给出 active_tasks、running_count、queued_count、allowed_actions。默认串行排队；parallel 只能在用户明确要求且 allowed_actions 允许时使用。queue_full 后按 next_action 先查询、等待或取消任务，禁止立即原样或并发重试。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
item_id | string 必填 | 目标平台的标准商品 ID；规则与 get_product_reviews.item_id 相同。 |
platform | string 可选 | 本任务唯一的平台/区域。每个任务只能采集一个平台。 默认： "amazon"可选： ["amazon", "target", "tkshop_us", "tkshop_sg", "tkshop_vn", "tkshop_id", "tkshop_th", "tkshop_my", "tkshop_ph"] |
max_items | integer 可选 | 本任务最多保存的评论总数，范围 1-5000；这是目标上限。Amazon 每个 ASIN+星级筛选条件最多 10 页；增大 max_items 不会切换星级或突破该上限。 默认： 5000最小值：1 · 最大值：5000 |
batch_limit | integer 可选 | 每个内部同步批次最多交付的评论数，范围 1-100；不是上游 page_size。 默认： 100最小值：1 · 最大值：100 |
min_rating | integer 可选 | 最低评分 1-5；Amazon 单一星级设 min_rating=max_rating；全部星级省略二者。 默认： null最小值：1 · 最大值：5 |
max_rating | integer 可选 | 最高评分 1-5；Amazon 单一星级设 min_rating=max_rating；不支持多星级区间。 默认： null最小值：1 · 最大值：5 |
verified_only | boolean 可选 | 仅保留已验证购买；Amazon V2 请省略或传 false，不支持购买验证筛选。 默认： false |
sort_by | string 可选 | 仅支持平台默认顺序，请省略或传 default。整个任务必须保持不变。 默认： "default"可选： ["default"] |
domain_name | string 可选 | Amazon 站点域名；当前仅支持美国站 www.amazon.com；德国、日本站已停止支持。省略或传空字符串表示美国站，且必须与 URL/ID 所属站点一致。 默认： ""可选： ["", "www.amazon.com"] |
on_conflict | string 可选 | 发现已有不同任务时的动作。默认 ask 不做破坏性操作并让 Agent 决策；reuse 保留并复用当前任务；queue 严格排在旧任务之后；cancel_previous 请求取消可访问的旧任务后排队；parallel 仅在用户明确要求并行、响应 allowed_actions 包含 parallel 且容量可用时执行。 默认： "ask"可选： ["ask", "reuse", "queue", "cancel_previous", "parallel"] |
force_refresh | boolean 可选 | false 时短期内相同已完成任务会复用；true 明确要求重新采集。 默认： false |
完整参数定义（JSON）
{
"description": "\u542f\u52a8\u5355\u4e00\u5e73\u53f0\u7684\u5546\u54c1\u8bc4\u8bba\u540e\u53f0\u91c7\u96c6\u3002Amazon \u6bcf\u4e2a ASIN+\u661f\u7ea7\u7b5b\u9009\u6761\u4ef6\u6700\u591a 10 \u9875\uff0c\u5355\u4e2a\u4efb\u52a1\u4e0d\u4f1a\u81ea\u52a8\u5207\u6362\u661f\u7ea7\uff1b\u6269\u5c55\u91c7\u96c6\u5148\u8bfb amazon_review_expansion \u5c42\u3002\u4efb\u52a1\u65ad\u7ebf\u540e\u7ee7\u7eed\u5e76\u9010\u6279 checkpoint\uff1b\u76f8\u540c\u53c2\u6570\u81ea\u52a8\u590d\u7528\u3002\u54cd\u5e94\u8fd4\u56de\u52a8\u6001 capacity\u3002\u82e5\u5f53\u524d\u5df2\u6709\u4e0d\u540c\u4efb\u52a1\uff0c\u9ed8\u8ba4\u8fd4\u56de decision_required\uff0c\u5e76\u540c\u65f6\u7ed9\u51fa active_tasks\u3001running_count\u3001queued_count\u3001allowed_actions\u3002\u9ed8\u8ba4\u4e32\u884c\u6392\u961f\uff1bparallel \u53ea\u80fd\u5728\u7528\u6237\u660e\u786e\u8981\u6c42\u4e14 allowed_actions \u5141\u8bb8\u65f6\u4f7f\u7528\u3002queue_full \u540e\u6309 next_action \u5148\u67e5\u8be2\u3001\u7b49\u5f85\u6216\u53d6\u6d88\u4efb\u52a1\uff0c\u7981\u6b62\u7acb\u5373\u539f\u6837\u6216\u5e76\u53d1\u91cd\u8bd5\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002",
"example": {
"batch_limit": 100,
"item_id": "B08N5WRWNW",
"max_items": 1000,
"on_conflict": "ask",
"platform": "amazon"
},
"name": "start_product_review_collection",
"parameters": {
"batch_limit": {
"default": 100,
"description": "\u6bcf\u4e2a\u5185\u90e8\u540c\u6b65\u6279\u6b21\u6700\u591a\u4ea4\u4ed8\u7684\u8bc4\u8bba\u6570\uff0c\u8303\u56f4 1-100\uff1b\u4e0d\u662f\u4e0a\u6e38 page_size\u3002",
"maximum": 100,
"minimum": 1,
"required": false,
"type": "integer"
},
"domain_name": {
"default": "",
"description": "Amazon \u7ad9\u70b9\u57df\u540d\uff1b\u5f53\u524d\u4ec5\u652f\u6301\u7f8e\u56fd\u7ad9 www.amazon.com\uff1b\u5fb7\u56fd\u3001\u65e5\u672c\u7ad9\u5df2\u505c\u6b62\u652f\u6301\u3002\u7701\u7565\u6216\u4f20\u7a7a\u5b57\u7b26\u4e32\u8868\u793a\u7f8e\u56fd\u7ad9\uff0c\u4e14\u5fc5\u987b\u4e0e URL/ID \u6240\u5c5e\u7ad9\u70b9\u4e00\u81f4\u3002",
"enum": [
"",
"www.amazon.com"
],
"examples": [
"www.amazon.com"
],
"required": false,
"type": "string"
},
"force_refresh": {
"default": false,
"description": "false \u65f6\u77ed\u671f\u5185\u76f8\u540c\u5df2\u5b8c\u6210\u4efb\u52a1\u4f1a\u590d\u7528\uff1btrue \u660e\u786e\u8981\u6c42\u91cd\u65b0\u91c7\u96c6\u3002",
"required": false,
"type": "boolean"
},
"item_id": {
"description": "\u76ee\u6807\u5e73\u53f0\u7684\u6807\u51c6\u5546\u54c1 ID\uff1b\u89c4\u5219\u4e0e get_product_reviews.item_id \u76f8\u540c\u3002",
"minLength": 1,
"required": true,
"type": "string"
},
"max_items": {
"default": 5000,
"description": "\u672c\u4efb\u52a1\u6700\u591a\u4fdd\u5b58\u7684\u8bc4\u8bba\u603b\u6570\uff0c\u8303\u56f4 1-5000\uff1b\u8fd9\u662f\u76ee\u6807\u4e0a\u9650\u3002Amazon \u6bcf\u4e2a ASIN+\u661f\u7ea7\u7b5b\u9009\u6761\u4ef6\u6700\u591a 10 \u9875\uff1b\u589e\u5927 max_items \u4e0d\u4f1a\u5207\u6362\u661f\u7ea7\u6216\u7a81\u7834\u8be5\u4e0a\u9650\u3002",
"maximum": 5000,
"minimum": 1,
"required": false,
"type": "integer"
},
"max_rating": {
"default": null,
"description": "\u6700\u9ad8\u8bc4\u5206 1-5\uff1bAmazon \u5355\u4e00\u661f\u7ea7\u8bbe min_rating=max_rating\uff1b\u4e0d\u652f\u6301\u591a\u661f\u7ea7\u533a\u95f4\u3002",
"maximum": 5,
"minimum": 1,
"required": false,
"type": "integer"
},
"min_rating": {
"default": null,
"description": "\u6700\u4f4e\u8bc4\u5206 1-5\uff1bAmazon \u5355\u4e00\u661f\u7ea7\u8bbe min_rating=max_rating\uff1b\u5168\u90e8\u661f\u7ea7\u7701\u7565\u4e8c\u8005\u3002",
"maximum": 5,
"minimum": 1,
"required": false,
"type": "integer"
},
"on_conflict": {
"default": "ask",
"description": "\u53d1\u73b0\u5df2\u6709\u4e0d\u540c\u4efb\u52a1\u65f6\u7684\u52a8\u4f5c\u3002\u9ed8\u8ba4 ask \u4e0d\u505a\u7834\u574f\u6027\u64cd\u4f5c\u5e76\u8ba9 Agent \u51b3\u7b56\uff1breuse \u4fdd\u7559\u5e76\u590d\u7528\u5f53\u524d\u4efb\u52a1\uff1bqueue \u4e25\u683c\u6392\u5728\u65e7\u4efb\u52a1\u4e4b\u540e\uff1bcancel_previous \u8bf7\u6c42\u53d6\u6d88\u53ef\u8bbf\u95ee\u7684\u65e7\u4efb\u52a1\u540e\u6392\u961f\uff1bparallel \u4ec5\u5728\u7528\u6237\u660e\u786e\u8981\u6c42\u5e76\u884c\u3001\u54cd\u5e94 allowed_actions \u5305\u542b parallel \u4e14\u5bb9\u91cf\u53ef\u7528\u65f6\u6267\u884c\u3002",
"enum": [
"ask",
"reuse",
"queue",
"cancel_previous",
"parallel"
],
"required": false,
"type": "string"
},
"platform": {
"default": "amazon",
"description": "\u672c\u4efb\u52a1\u552f\u4e00\u7684\u5e73\u53f0/\u533a\u57df\u3002\u6bcf\u4e2a\u4efb\u52a1\u53ea\u80fd\u91c7\u96c6\u4e00\u4e2a\u5e73\u53f0\u3002",
"enum": [
"amazon",
"target",
"tkshop_us",
"tkshop_sg",
"tkshop_vn",
"tkshop_id",
"tkshop_th",
"tkshop_my",
"tkshop_ph"
],
"required": false,
"type": "string"
},
"sort_by": {
"default": "default",
"description": "\u4ec5\u652f\u6301\u5e73\u53f0\u9ed8\u8ba4\u987a\u5e8f\uff0c\u8bf7\u7701\u7565\u6216\u4f20 default\u3002\u6574\u4e2a\u4efb\u52a1\u5fc5\u987b\u4fdd\u6301\u4e0d\u53d8\u3002",
"enum": [
"default"
],
"required": false,
"type": "string",
"x-realtrace-platform-capabilities": {
"amazon": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"target": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_id": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_my": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_ph": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_sg": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_th": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_us": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
},
"tkshop_vn": {
"accepted_values": [
"default"
],
"default_order": "platform_default",
"omit_when_default": true,
"selectable": false
}
}
},
"verified_only": {
"default": false,
"description": "\u4ec5\u4fdd\u7559\u5df2\u9a8c\u8bc1\u8d2d\u4e70\uff1bAmazon V2 \u8bf7\u7701\u7565\u6216\u4f20 false\uff0c\u4e0d\u652f\u6301\u8d2d\u4e70\u9a8c\u8bc1\u7b5b\u9009\u3002",
"required": false,
"type": "boolean"
}
}
}list_collection_tasks2 个参数
列出当前用户的运行中和排队采集任务，并返回动态 capacity、running_count/queued_count、剩余运行/排队槽位，以及 has_active_task/has_unfinished_task/has_running_task/has_queued_task。当前 Key 无权访问的平台任务只显示非敏感状态。准备启动两个或更多可能转后台的调用前必须先调用；跨平台任务默认逐个提交。状态/控制查询不调用上游、不占普通数据执行槽且不计费。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
include_finished | boolean 可选 | 是否同时返回最近完成、失败和已取消任务。 默认： false |
limit | integer 可选 | 最多返回的任务记录数，范围 1-100。 默认： 20最小值：1 · 最大值：100 |
完整参数定义（JSON）
{
"description": "\u5217\u51fa\u5f53\u524d\u7528\u6237\u7684\u8fd0\u884c\u4e2d\u548c\u6392\u961f\u91c7\u96c6\u4efb\u52a1\uff0c\u5e76\u8fd4\u56de\u52a8\u6001 capacity\u3001running_count/queued_count\u3001\u5269\u4f59\u8fd0\u884c/\u6392\u961f\u69fd\u4f4d\uff0c\u4ee5\u53ca has_active_task/has_unfinished_task/has_running_task/has_queued_task\u3002\u5f53\u524d Key \u65e0\u6743\u8bbf\u95ee\u7684\u5e73\u53f0\u4efb\u52a1\u53ea\u663e\u793a\u975e\u654f\u611f\u72b6\u6001\u3002\u51c6\u5907\u542f\u52a8\u4e24\u4e2a\u6216\u66f4\u591a\u53ef\u80fd\u8f6c\u540e\u53f0\u7684\u8c03\u7528\u524d\u5fc5\u987b\u5148\u8c03\u7528\uff1b\u8de8\u5e73\u53f0\u4efb\u52a1\u9ed8\u8ba4\u9010\u4e2a\u63d0\u4ea4\u3002\u72b6\u6001/\u63a7\u5236\u67e5\u8be2\u4e0d\u8c03\u7528\u4e0a\u6e38\u3001\u4e0d\u5360\u666e\u901a\u6570\u636e\u6267\u884c\u69fd\u4e14\u4e0d\u8ba1\u8d39\u3002",
"example": {
"include_finished": false,
"limit": 20
},
"name": "list_collection_tasks",
"parameters": {
"include_finished": {
"default": false,
"description": "\u662f\u5426\u540c\u65f6\u8fd4\u56de\u6700\u8fd1\u5b8c\u6210\u3001\u5931\u8d25\u548c\u5df2\u53d6\u6d88\u4efb\u52a1\u3002",
"required": false,
"type": "boolean"
},
"limit": {
"default": 20,
"description": "\u6700\u591a\u8fd4\u56de\u7684\u4efb\u52a1\u8bb0\u5f55\u6570\uff0c\u8303\u56f4 1-100\u3002",
"maximum": 100,
"minimum": 1,
"required": false,
"type": "integer"
}
}
}get_collection_task_status3 个参数
读取或短暂等待一个持久业务任务的状态、进度、target_reached/shortfall/completion_reason 和 allowed_actions；不调用上游且不计费。状态轮询次数取决于进度变化，与内部上游页数无固定关系；不得重复原业务请求。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
task_id | string 必填 | 业务工具自动返回或 start_product_review_collection 返回的 task_id。 |
wait_seconds | integer 可选 | 可选长轮询等待秒数，范围 0-25；有新进度会提前返回。 默认： 0最小值：0 · 最大值：25 |
after_version | string 可选 | 上一次 task.progress_version；仅在版本未变化时等待，必须逐字回传。 默认： "" |
完整参数定义（JSON）
{
"description": "\u8bfb\u53d6\u6216\u77ed\u6682\u7b49\u5f85\u4e00\u4e2a\u6301\u4e45\u4e1a\u52a1\u4efb\u52a1\u7684\u72b6\u6001\u3001\u8fdb\u5ea6\u3001target_reached/shortfall/completion_reason \u548c allowed_actions\uff1b\u4e0d\u8c03\u7528\u4e0a\u6e38\u4e14\u4e0d\u8ba1\u8d39\u3002\u72b6\u6001\u8f6e\u8be2\u6b21\u6570\u53d6\u51b3\u4e8e\u8fdb\u5ea6\u53d8\u5316\uff0c\u4e0e\u5185\u90e8\u4e0a\u6e38\u9875\u6570\u65e0\u56fa\u5b9a\u5173\u7cfb\uff1b\u4e0d\u5f97\u91cd\u590d\u539f\u4e1a\u52a1\u8bf7\u6c42\u3002",
"example": {
"task_id": "collect_\u003ctask_id\u003e"
},
"name": "get_collection_task_status",
"parameters": {
"after_version": {
"default": "",
"description": "\u4e0a\u4e00\u6b21 task.progress_version\uff1b\u4ec5\u5728\u7248\u672c\u672a\u53d8\u5316\u65f6\u7b49\u5f85\uff0c\u5fc5\u987b\u9010\u5b57\u56de\u4f20\u3002",
"maxLength": 256,
"required": false,
"type": "string"
},
"task_id": {
"description": "\u4e1a\u52a1\u5de5\u5177\u81ea\u52a8\u8fd4\u56de\u6216 start_product_review_collection \u8fd4\u56de\u7684 task_id\u3002",
"maxLength": 128,
"minLength": 1,
"required": true,
"type": "string"
},
"wait_seconds": {
"default": 0,
"description": "\u53ef\u9009\u957f\u8f6e\u8be2\u7b49\u5f85\u79d2\u6570\uff0c\u8303\u56f4 0-25\uff1b\u6709\u65b0\u8fdb\u5ea6\u4f1a\u63d0\u524d\u8fd4\u56de\u3002",
"maximum": 25,
"minimum": 0,
"required": false,
"type": "integer"
}
}
}cancel_collection_task1 个参数
协作式取消当前用户中、当前 API Key 有平台权限的采集任务。已发出的上游请求完成后停止，已 checkpoint 的部分结果保留；重复取消幂等且不计费。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
task_id | string 必填 | 要取消的 task_id。 |
完整参数定义（JSON）
{
"description": "\u534f\u4f5c\u5f0f\u53d6\u6d88\u5f53\u524d\u7528\u6237\u4e2d\u3001\u5f53\u524d API Key \u6709\u5e73\u53f0\u6743\u9650\u7684\u91c7\u96c6\u4efb\u52a1\u3002\u5df2\u53d1\u51fa\u7684\u4e0a\u6e38\u8bf7\u6c42\u5b8c\u6210\u540e\u505c\u6b62\uff0c\u5df2 checkpoint \u7684\u90e8\u5206\u7ed3\u679c\u4fdd\u7559\uff1b\u91cd\u590d\u53d6\u6d88\u5e42\u7b49\u4e14\u4e0d\u8ba1\u8d39\u3002",
"example": {
"task_id": "collect_\u003ctask_id\u003e"
},
"name": "cancel_collection_task",
"parameters": {
"task_id": {
"description": "\u8981\u53d6\u6d88\u7684 task_id\u3002",
"maxLength": 128,
"minLength": 1,
"required": true,
"type": "string"
}
}
}resume_collection_task1 个参数
从持久 checkpoint 恢复 failed、paused 或 cancelled_partial 任务；不从第一页重来。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
task_id | string 必填 | 要恢复的 task_id。 |
完整参数定义（JSON）
{
"description": "\u4ece\u6301\u4e45 checkpoint \u6062\u590d failed\u3001paused \u6216 cancelled_partial \u4efb\u52a1\uff1b\u4e0d\u4ece\u7b2c\u4e00\u9875\u91cd\u6765\u3002 \u9996\u6b21\u67e5\u8be2\u81ea\u52a8\u68c0\u67e5\u5f53\u524d\u53ef\u7528\u6027\uff1bservice_query_unavailable \u65f6\u505c\u6b62\u8be5\u5e73\u53f0/\u529f\u80fd\uff0c\u9075\u5b88 retryable=false\uff0c\u4e0d\u91cd\u8bd5\u6216\u81ea\u52a8\u8f6e\u8be2\uff0c\u4e0d\u5efa\u8bae\u6062\u590d\u65f6\u95f4\u3002\u52a8\u6001\u72b6\u6001\u968f get_agent_instructions \u8fd4\u56de\uff0c\u65e0\u9700\u5148\u989d\u5916\u8c03\u7528\u5b83\u518d\u67e5\u8be2\u3002",
"example": {
"task_id": "collect_\u003ctask_id\u003e"
},
"name": "resume_collection_task",
"parameters": {
"task_id": {
"description": "\u8981\u6062\u590d\u7684 task_id\u3002",
"maxLength": 128,
"minLength": 1,
"required": true,
"type": "string"
}
}
}get_collection_task_result3 个参数
免费读取已经持久化的采集结果，每次最多 100 条；100 条任务用 limit=100 时最多读取一次。1000 条最多 10 个结果页，指存储读取，不是业务重放或上游调用。all_results_read 表示读完，target_reached 单独表示是否达到任务数量目标。读完后若 continuation_available=true，continuation_cursor 是原业务工具的续采游标；仅在用户仍需更多时执行 continuation.tool/arguments。next_cursor 仍只用于本工具读取已存结果，两者不可混用。upstream_result_set_exhausted 只表示所选查询场景结束。
| 参数 | 类型 / 必填 | 说明 |
|---|---|---|
task_id | string 必填 | 要读取结果的 task_id。 |
limit | integer 可选 | 本次读取的已存储结果上限，范围 1-100。 默认： 100最小值：1 · 最大值：100 |
cursor | string 可选 | 首轮留空；后续逐字回传本工具上一响应的 next_cursor。 默认： "" |
完整参数定义（JSON）
{
"description": "\u514d\u8d39\u8bfb\u53d6\u5df2\u7ecf\u6301\u4e45\u5316\u7684\u91c7\u96c6\u7ed3\u679c\uff0c\u6bcf\u6b21\u6700\u591a 100 \u6761\uff1b100 \u6761\u4efb\u52a1\u7528 limit=100 \u65f6\u6700\u591a\u8bfb\u53d6\u4e00\u6b21\u30021000 \u6761\u6700\u591a 10 \u4e2a\u7ed3\u679c\u9875\uff0c\u6307\u5b58\u50a8\u8bfb\u53d6\uff0c\u4e0d\u662f\u4e1a\u52a1\u91cd\u653e\u6216\u4e0a\u6e38\u8c03\u7528\u3002all_results_read \u8868\u793a\u8bfb\u5b8c\uff0ctarget_reached \u5355\u72ec\u8868\u793a\u662f\u5426\u8fbe\u5230\u4efb\u52a1\u6570\u91cf\u76ee\u6807\u3002\u8bfb\u5b8c\u540e\u82e5 continuation_available=true\uff0ccontinuation_cursor \u662f\u539f\u4e1a\u52a1\u5de5\u5177\u7684\u7eed\u91c7\u6e38\u6807\uff1b\u4ec5\u5728\u7528\u6237\u4ecd\u9700\u66f4\u591a\u65f6\u6267\u884c continuation.tool/arguments\u3002next_cursor \u4ecd\u53ea\u7528\u4e8e\u672c\u5de5\u5177\u8bfb\u53d6\u5df2\u5b58\u7ed3\u679c\uff0c\u4e24\u8005\u4e0d\u53ef\u6df7\u7528\u3002upstream_result_set_exhausted \u53ea\u8868\u793a\u6240\u9009\u67e5\u8be2\u573a\u666f\u7ed3\u675f\u3002",
"example": {
"cursor": "",
"limit": 100,
"task_id": "collect_\u003ctask_id\u003e"
},
"name": "get_collection_task_result",
"parameters": {
"cursor": {
"default": "",
"description": "\u9996\u8f6e\u7559\u7a7a\uff1b\u540e\u7eed\u9010\u5b57\u56de\u4f20\u672c\u5de5\u5177\u4e0a\u4e00\u54cd\u5e94\u7684 next_cursor\u3002",
"required": false,
"type": "string"
},
"limit": {
"default": 100,
"description": "\u672c\u6b21\u8bfb\u53d6\u7684\u5df2\u5b58\u50a8\u7ed3\u679c\u4e0a\u9650\uff0c\u8303\u56f4 1-100\u3002",
"maximum": 100,
"minimum": 1,
"required": false,
"type": "integer"
},
"task_id": {
"description": "\u8981\u8bfb\u53d6\u7ed3\u679c\u7684 task_id\u3002",
"maxLength": 128,
"minLength": 1,
"required": true,
"type": "string"
}
}
}08 / TRY IT
连接后可以这样提问
- 使用 RealTrace 在 Amazon 美国站搜索 wireless mouse，返回前 5 个商品的标题、价格、评分和商品链接，并用表格展示。
- 使用 RealTrace 在 YouTube 搜索 smoke alarm，返回前 5 条视频的标题、发布账号和原始链接，总结这些视频讨论的主题。
- 使用 RealTrace 在 Target 搜索 wireless headphones，选择搜索结果中的第一件商品，读取最多 10 条评论，归纳主要优缺点并保留商品链接。
以上为可执行的测试问题，实际结果取决于平台数据、账户权限与可用额度。客户端须支持远程 MCP、请求头配置和工具调用；在应用市场选择 API Key 鉴权时，密钥获取地址为 https://realtrace.cangxuandata.com/dashboard/keys。