{"name":"RealTrace","version":"5.6","connection":{"url":"https://realtrace.cangxuandata.com/mcp","transport":"Streamable HTTP","authentication":"Authorization: Bearer <YOUR_API_KEY>"},"tools":[{"name":"get_agent_instructions","description":"按 section 分层返回 V19 下游 Agent 调用契约，每次只读取当前所需的一层，不要一次读取全部内容。首次调用 section=index；普通任务读取 core 和一个业务层，需要更多或全量数据时再读取 more_data 和对应的一个 more_* 层。逐工具参数始终以 tools/list 为准。","parameters":{"section":{"type":"string","required":false,"default":"index","description":"要读取的 V19 契约层。首次必须用 index；开始调用数据工具前读 core 和当前业务层。用户要求更多、100/1000 条或尽可能全量时，读 more_data 后只读对应的 more_commerce、more_social、more_creators 或 more_tasks。","enum":["index","core","commerce","social","creators","tasks","more_data","more_commerce","amazon_review_expansion","more_social","more_creators","more_tasks","pagination_errors_billing"]}},"example":{"section":"index"}},{"name":"search_products","description":"按关键词发现商品并返回后续工具所需的标准商品 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，且不得重复原业务调用。","parameters":{"keyword":{"type":"string","required":true,"description":"商品、品牌或需求关键词；不能留空。","examples":["Apple","wireless mouse"],"minLength":1},"platform":{"type":"string","required":false,"default":"amazon","description":"目标电商平台；Target 后续调用使用搜索结果 TCIN，TikTok Shop 后续调用必须保持同一区域。","enum":["amazon","walmart","target","tkshop_us","tkshop_sg","tkshop_vn","tkshop_id","tkshop_th","tkshop_my","tkshop_ph"]},"limit":{"type":"integer","required":false,"default":10,"description":"本次调用的目标返回上限，范围 1-100；服务会按需跨上游分页，但上游不足、筛选、时间或页数边界可能使结果少于该数量。","minimum":1,"maximum":100},"ai_enhance":{"type":"boolean","required":false,"default":false,"description":"是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。"},"cursor":{"type":"string","required":false,"default":"","description":"首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。"},"domain_name":{"type":"string","required":false,"default":"","description":"Amazon 站点域名；当前仅支持美国站 www.amazon.com；德国、日本站已停止支持。省略或传空字符串表示美国站，且必须与 URL/ID 所属站点一致。","enum":["","www.amazon.com"],"examples":["www.amazon.com"]}},"example":{"keyword":"smoke alarm","platform":"amazon","limit":20}},{"name":"get_product_details","description":"通过平台标准商品 ID 获取详情；只有名称时先 search_products。Amazon 商品 URL 可自动提取 ASIN。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。","parameters":{"item_id":{"type":"string","required":true,"description":"Amazon=10 位 ASIN，Walmart=search_products 返回的数字 num_iid，Target=搜索返回的数字 TCIN，TikTok Shop=同一区域搜索返回的数字 product_id；不得传品牌名或商品标题。","examples":["B0D54JZTHY"],"minLength":1},"platform":{"type":"string","required":false,"default":"amazon","description":"item_id 所属平台；必须与产生该 ID 的搜索结果一致。","enum":["amazon","walmart","target","tkshop_us","tkshop_sg","tkshop_vn","tkshop_id","tkshop_th","tkshop_my","tkshop_ph"]},"ai_enhance":{"type":"boolean","required":false,"default":false,"description":"是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。"},"domain_name":{"type":"string","required":false,"default":"","description":"Amazon 站点域名；当前仅支持美国站 www.amazon.com；德国、日本站已停止支持。省略或传空字符串表示美国站，且必须与 URL/ID 所属站点一致。","enum":["","www.amazon.com"],"examples":["www.amazon.com"]}},"example":{"item_id":"B0CJMP7WHH","platform":"amazon"}},{"name":"get_product_reviews","description":"通过单一平台的标准商品 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，且不得重复原业务调用。","parameters":{"item_id":{"type":"string","required":true,"description":"Amazon=10 位 ASIN；Target=search_products 返回的数字 TCIN；TikTok Shop=同一区域搜索返回的数字 product_id。不得传品牌名、标题、DPCI、Seller ID 或跨区 ID。","minLength":1},"platform":{"type":"string","required":false,"default":"amazon","description":"评论对应的平台/区域；社媒评论请改用 get_social_comments。","enum":["amazon","target","tkshop_us","tkshop_sg","tkshop_vn","tkshop_id","tkshop_th","tkshop_my","tkshop_ph"]},"limit":{"type":"integer","required":false,"description":"已废弃的取数目标别名；旧客户端仍可传 1-100。新调用请改用 target_count。","minimum":1,"maximum":100,"deprecated":true},"target_count":{"type":"integer","required":false,"description":"一次业务请求希望交付的评论上限，范围 1-100；不是上游页大小，也不要求下游按上游页数重复调用。服务在内部沿同一查询场景分页；达到同步预算时可能转后台或返回部分结果与 next_cursor。","minimum":1,"maximum":100},"ai_enhance":{"type":"boolean","required":false,"default":false,"description":"是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。"},"min_rating":{"type":"integer","required":false,"default":null,"description":"最低评分，1-5。Amazon 单一星级须 min_rating=max_rating；省略二者或 1..5 表示全部，不支持其他区间。其他平台保持原有能力。","minimum":1,"maximum":5},"max_rating":{"type":"integer","required":false,"default":null,"description":"最高评分，1-5。Amazon 单一星级须 min_rating=max_rating；续页保持相同筛选。其他平台保持原有能力。","minimum":1,"maximum":5},"verified_only":{"type":"boolean","required":false,"default":false,"description":"只返回已验证购买评论；Amazon V2 不支持，请省略或传 false。其他平台保持原有能力；缺失的验证字段不代表 false。"},"sort_by":{"type":"string","required":false,"default":"default","description":"商品评论仅支持平台默认顺序，请省略或传 default；Amazon V2 不支持 hot/newest。","enum":["default"],"x-realtrace-platform-capabilities":{"amazon":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"target":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_us":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_sg":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_vn":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_id":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_th":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_my":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_ph":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true}}},"cursor":{"type":"string","required":false,"default":"","description":"首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。"},"domain_name":{"type":"string","required":false,"default":"","description":"Amazon 站点域名；当前仅支持美国站 www.amazon.com；德国、日本站已停止支持。省略或传空字符串表示美国站，且必须与 URL/ID 所属站点一致。","enum":["","www.amazon.com"],"examples":["www.amazon.com"]}},"example":{"item_id":"B0CJMP7WHH","min_rating":1,"max_rating":1,"limit":20}},{"name":"get_social_comments","description":"通过社媒平台评论入口 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，且不得重复原业务调用。","parameters":{"target_id":{"type":"string","required":true,"description":"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。","minLength":1},"platform":{"type":"string","required":true,"description":"target_id 所属平台；必须与产生该 ID 的前序搜索/详情结果一致。","enum":["tiktok","youtube","reddit","facebook","instagram","linkedin","twitter"]},"limit":{"type":"integer","required":false,"default":10,"description":"本次调用的目标返回上限，范围 1-100；服务会按需跨上游分页，但上游不足、筛选、时间或页数边界可能使结果少于该数量。","minimum":1,"maximum":100},"ai_enhance":{"type":"boolean","required":false,"default":false,"description":"是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。"},"sort_by":{"type":"string","required":false,"default":"default","description":"仅 Reddit 可自选：传 default/newest/best/top，其中 default 等同 newest。其他平台（含 LinkedIn/X）省略 sort_by；LinkedIn 固定 relevance，X 固定 latest。旧调用显式传 default 继续兼容。","enum":["default","newest","best","top"],"x-realtrace-platform-capabilities":{"tiktok":{"selectable":false,"accepted_values":[],"default_order":"platform_default","omit_when_not_selectable":true,"legacy_accepted_values":["default"]},"youtube":{"selectable":false,"accepted_values":[],"default_order":"platform_default","omit_when_not_selectable":true,"legacy_accepted_values":["default"]},"reddit":{"selectable":true,"accepted_values":["default","newest","best","top"],"default_order":"newest","omit_when_not_selectable":false,"legacy_accepted_values":[]},"facebook":{"selectable":false,"accepted_values":[],"default_order":"platform_default","omit_when_not_selectable":true,"legacy_accepted_values":["default"]},"instagram":{"selectable":false,"accepted_values":[],"default_order":"platform_default","omit_when_not_selectable":true,"legacy_accepted_values":["default"]},"linkedin":{"selectable":false,"accepted_values":[],"default_order":"relevance","omit_when_not_selectable":true,"legacy_accepted_values":["default"]},"twitter":{"selectable":false,"accepted_values":[],"default_order":"latest","omit_when_not_selectable":true,"legacy_accepted_values":["default"]}}},"cursor":{"type":"string","required":false,"default":"","description":"首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。"}},"example":{"target_id":"7123456789","platform":"tiktok","limit":10}},{"name":"get_comment_replies","description":"获取一级评论回复；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，且不得重复原业务调用。","parameters":{"comment_id":{"type":"string","required":true,"description":"逐字使用 get_social_comments.replyable_comment.id；Facebook 返回值已组合为 id:expansion_token，不要自行拼接。","minLength":1},"platform":{"type":"string","required":true,"description":"评论所属平台。","enum":["facebook","reddit","youtube"]},"limit":{"type":"integer","required":false,"default":10,"description":"本次调用的目标返回上限，范围 1-100；服务会按需跨上游分页，但上游不足、筛选、时间或页数边界可能使结果少于该数量。","minimum":1,"maximum":100},"ai_enhance":{"type":"boolean","required":false,"default":false,"description":"是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。"},"cursor":{"type":"string","required":false,"default":"","description":"首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。"},"video_id":{"type":"string","required":false,"default":"","description":"仅 YouTube 必填；逐字使用 get_social_comments 响应中的 video_id/target_id，其他平台留空。","examples":["dQw4w9WgXcQ"],"required_when":{"platform":"youtube"}}},"example":{"comment_id":"UgxCommentId","video_id":"74-dXafKB4Y","platform":"youtube","limit":20}},{"name":"get_shop_info","description":"通过店铺内一个当前可访问商品的 product_id 查询 TikTok Shop 店铺；不得传真实 seller_id、店铺名或跨区 ID。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。","parameters":{"product_id":{"type":"string","required":true,"description":"必须来自同一区域 search_products 结果中、属于目标店铺的数字 product_id；不是 seller_id 或店铺名。","minLength":1},"platform":{"type":"string","required":false,"default":"tkshop_us","description":"商品所在 TikTok Shop 区域，必须与 product_id 的来源一致。","enum":["tkshop_us","tkshop_sg","tkshop_vn","tkshop_id","tkshop_th","tkshop_my","tkshop_ph"]},"ai_enhance":{"type":"boolean","required":false,"default":false,"description":"是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。"}},"example":{"product_id":"1730084177840870362","platform":"tkshop_us"}},{"name":"get_rankings","description":"获取 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，且不得重复原业务调用。","parameters":{"category_url":{"type":"string","required":false,"default":null,"description":"完整 Amazon BSR/Best Sellers 分类页面 URL，需包含 amazon 站点及 /gp/bestsellers/ 或 /zgbs/ 路径。","examples":["https://www.amazon.com/gp/bestsellers/pc/13896615011"],"minLength":1,"maxLength":2048,"pattern":"^https://"},"limit":{"type":"integer","required":false,"default":10,"description":"本次调用的目标返回上限，范围 1-100；服务会按需跨上游分页，但上游不足、筛选、时间或页数边界可能使结果少于该数量。","minimum":1,"maximum":100},"ai_enhance":{"type":"boolean","required":false,"default":false,"description":"是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。"},"cursor":{"type":"string","required":false,"default":"","description":"首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。"}},"example":{"category_url":"https://www.amazon.com/Best-Sellers-Smoke-Detectors/zgbs/hi/495270","limit":30}},{"name":"search_posts","description":"按关键词跨社媒平台发现内容。返回 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，且不得重复原业务调用。","parameters":{"keyword":{"type":"string","required":true,"description":"搜索关键词；Facebook/Instagram 建议使用单个英文词，不能留空。","examples":["apple","home safety"],"minLength":1,"maxLength":200},"platform":{"type":"string","required":false,"description":"已废弃的兼容参数：仅允许一个平台。新调用请改用只含一个键的 platforms 对象；不得与 platforms 混用。","examples":["youtube"],"minLength":1,"maxLength":80,"pattern":"^(?:tiktok|youtube|reddit|facebook|instagram|twitter)$","deprecated":true},"limit":{"type":"integer","required":false,"description":"已废弃的兼容参数：单一平台的目标返回上限。新调用请改传 platforms.<platform>.limit。","minimum":1,"maximum":100,"deprecated":true},"ai_enhance":{"type":"boolean","required":false,"default":false,"description":"是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。"},"content_type":{"type":"string","required":false,"description":"已废弃的全局兼容参数。新调用请在每个平台对象内传其 schema 限定的 content_type；切换类型后从空 cursor 重新开始。","enum":["default","all","video","posts","media"],"deprecated":true},"sort_by":{"type":"string","required":false,"description":"已废弃的全局兼容参数。新调用仅在 platforms.facebook 或 platforms.twitter 的 sort_by 传各自 schema 枚举；YouTube、TikTok、Reddit、Instagram 不接受该字段。","enum":["relevance","newest","rating","viewCount"],"deprecated":true,"x-realtrace-platform-capabilities":{"tiktok":{"selectable":false,"accepted_values":[],"default_order":"newest","omit_when_not_selectable":true,"legacy_accepted_values":["relevance","newest"]},"youtube":{"selectable":false,"accepted_values":[],"default_order":"platform_default","omit_when_not_selectable":true,"legacy_accepted_values":[]},"reddit":{"selectable":false,"accepted_values":[],"default_order":"platform_default","omit_when_not_selectable":true,"legacy_accepted_values":["relevance"]},"facebook":{"selectable":true,"accepted_values":["relevance","newest"],"default_order":"relevance","omit_when_not_selectable":false,"legacy_accepted_values":[]},"instagram":{"selectable":false,"accepted_values":[],"default_order":"platform_default","omit_when_not_selectable":true,"legacy_accepted_values":["relevance"]},"twitter":{"selectable":true,"accepted_values":["relevance","newest"],"default_order":"relevance","omit_when_not_selectable":false,"legacy_accepted_values":[]}}},"cursor":{"type":"string","required":false,"description":"已废弃的全局兼容续页参数。新调用请逐字回传 platforms.<platform>.cursor，值来自 platform_summary.<platform>.next_cursor。","deprecated":true},"platforms":{"type":"object","required":false,"description":"推荐格式。每次只能出现一个平台键；跨平台分析请由 Agent 分别调用后汇总。未传字段使用该平台默认值，非法参数会在调用上游和计费前拒绝。","examples":[{"facebook":{"content_type":"all","sort_by":"newest","limit":50}}],"properties":{"tiktok":{"type":"object","description":"选择 tiktok 并配置该平台自己的搜索参数。","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"该平台的目标返回上限；省略时默认 10。"},"content_type":{"type":"string","enum":["default","video"],"default":"default","description":"仅可使用该平台声明的内容类型；省略时使用平台默认类型。"},"cursor":{"type":"string","default":"","description":"首轮省略；续页时逐字回传该平台上一次响应中的 platform_summary.<platform>.next_cursor。"}},"additionalProperties":false},"youtube":{"type":"object","description":"选择 youtube 并配置该平台自己的搜索参数。","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"该平台的目标返回上限；省略时默认 10。"},"content_type":{"type":"string","enum":["default","all","video","shorts"],"default":"default","description":"仅可使用该平台声明的内容类型；省略时使用平台默认类型。"},"cursor":{"type":"string","default":"","description":"首轮省略；续页时逐字回传该平台上一次响应中的 platform_summary.<platform>.next_cursor。"}},"additionalProperties":false},"reddit":{"type":"object","description":"选择 reddit 并配置该平台自己的搜索参数。","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"该平台的目标返回上限；省略时默认 10。"},"content_type":{"type":"string","enum":["default","posts","media"],"default":"default","description":"仅可使用该平台声明的内容类型；省略时使用平台默认类型。"},"cursor":{"type":"string","default":"","description":"首轮省略；续页时逐字回传该平台上一次响应中的 platform_summary.<platform>.next_cursor。"}},"additionalProperties":false},"facebook":{"type":"object","description":"选择 facebook 并配置该平台自己的搜索参数。","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"该平台的目标返回上限；省略时默认 10。"},"content_type":{"type":"string","enum":["default","video","all"],"default":"default","description":"仅可使用该平台声明的内容类型；省略时使用平台默认类型。"},"cursor":{"type":"string","default":"","description":"首轮省略；续页时逐字回传该平台上一次响应中的 platform_summary.<platform>.next_cursor。"},"sort_by":{"type":"string","enum":["relevance","newest"],"default":"relevance","description":"该平台的排序方式；省略时使用声明的默认值。"}},"additionalProperties":false},"instagram":{"type":"object","description":"选择 instagram 并配置该平台自己的搜索参数。","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"该平台的目标返回上限；省略时默认 10。"},"content_type":{"type":"string","enum":["default","posts"],"default":"default","description":"仅可使用该平台声明的内容类型；省略时使用平台默认类型。"},"cursor":{"type":"string","default":"","description":"首轮省略；续页时逐字回传该平台上一次响应中的 platform_summary.<platform>.next_cursor。"}},"additionalProperties":false},"twitter":{"type":"object","description":"选择 twitter 并配置该平台自己的搜索参数。","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"default":10,"description":"该平台的目标返回上限；省略时默认 10。"},"content_type":{"type":"string","enum":["default","posts"],"default":"default","description":"仅可使用该平台声明的内容类型；省略时使用平台默认类型。"},"cursor":{"type":"string","default":"","description":"首轮省略；续页时逐字回传该平台上一次响应中的 platform_summary.<platform>.next_cursor。"},"sort_by":{"type":"string","enum":["relevance","newest"],"default":"relevance","description":"该平台的排序方式；省略时使用声明的默认值。"}},"additionalProperties":false}},"additionalProperties":false,"minProperties":1,"maxProperties":1}},"example":{"keyword":"fire safety home","platforms":{"youtube":{"limit":10,"sort_by":"newest"}}},"input_constraints":{"oneOf":[{"title":"platform-scoped format","required":["platforms"],"not":{"anyOf":[{"required":["platform"]},{"required":["limit"]},{"required":["content_type"]},{"required":["sort_by"]},{"required":["cursor"]}]}},{"title":"deprecated legacy format","required":["platform"],"not":{"required":["platforms"]}}],"x-realtrace-request-formats":{"preferred":"platforms","legacy":["platform","limit","content_type","sort_by","cursor"],"mixing_allowed":false}}},{"name":"get_post_details","description":"通过平台内容 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 返回，无需先额外调用它再查询。","parameters":{"url":{"type":"string","required":true,"description":"目标平台的帖子/视频 URL；YouTube 可传 11 位 video_id，TikTok 可传数字 video_id，Reddit 可传 posts_id。不得传标题或关键词。","minLength":1,"maxLength":2048},"platform":{"type":"string","required":true,"description":"URL/内容 ID 所属平台。","enum":["reddit","tiktok","facebook","instagram","youtube"]},"ai_enhance":{"type":"boolean","required":false,"default":false,"description":"是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。"}},"example":{"url":"https://www.reddit.com/r/Home/comments/abc123","platform":"reddit"}},{"name":"get_creator_info","description":"通过平台标准账号 ID 获取创作者信息；X 使用 platform=twitter 与数字 Rest ID；LinkedIn 使用 /in/ 后的 username，也可传完整 linkedin.com/in/... URL并自动提取。显示名和关键词不能代替稳定 ID。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。","parameters":{"creator_id":{"type":"string","required":true,"description":"TikTok/Instagram=search_posts 返回的数字 user_id；YouTube=channel_id；Reddit=帖子详情 author 用户名；Facebook=主页 URL；X(platform=twitter)=数字 Rest ID；LinkedIn=/in/ 后的 username 或完整 profile URL。","minLength":1},"platform":{"type":"string","required":true,"description":"creator_id 所属平台。","enum":["tiktok","youtube","reddit","facebook","instagram","linkedin","twitter"]},"ai_enhance":{"type":"boolean","required":false,"default":false,"description":"是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。"}},"example":{"creator_id":"username","platform":"tiktok"}},{"name":"get_creator_posts","description":"通过平台标准账号 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，且不得重复原业务调用。","parameters":{"platform":{"type":"string","required":true,"description":"账号平台；X 必须写 twitter；Reddit 当前没有账号内容上游能力。","enum":["tiktok","youtube","facebook","instagram","linkedin","twitter"]},"account_id":{"type":"string","required":true,"description":"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、显示名或关键词。","minLength":1},"account_url":{"type":"string","required":false,"default":"","description":"Facebook 和 LinkedIn 必填：分别传与 account_id 匹配的 facebook.com 主页 URL 或完整 https://www.linkedin.com/in/<username> URL；其他平台留空。"},"limit":{"type":"integer","required":false,"default":10,"description":"本次调用的目标返回上限，范围 1-100；服务会按需跨上游分页，但上游不足、筛选、时间或页数边界可能使结果少于该数量。","minimum":1,"maximum":100},"cursor":{"type":"string","required":false,"default":"","description":"首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。"},"content_type":{"type":"string","required":false,"default":"video","description":"仅 Facebook 可选 video/photos；其他平台保持默认 video。Instagram、LinkedIn、X 的实际返回 content_type 为 post。","enum":["video","photos"]},"ai_enhance":{"type":"boolean","required":false,"default":false,"description":"是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。"}},"example":{"platform":"youtube","account_id":"UCxxxxxxxxxxxxxxxxxxxxxx","limit":10}},{"name":"get_captions","description":"获取 YouTube 字幕；必须提供 YouTube 视频 URL 或 11 位 video_id，只有标题/关键词时先 search_posts。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。","parameters":{"video_url":{"type":"string","required":true,"description":"YouTube watch/shorts/embed/youtu.be URL，或 11 位 video_id；不得传标题、关键词或频道 ID。","examples":["https://www.youtube.com/watch?v=dQw4w9WgXcQ","dQw4w9WgXcQ"],"minLength":1},"platform":{"type":"string","required":false,"default":"youtube","description":"当前仅支持 youtube。","enum":["youtube"]},"ai_enhance":{"type":"boolean","required":false,"default":false,"description":"是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。"}},"example":{"video_url":"https://www.youtube.com/watch?v=74-dXafKB4Y","platform":"youtube"}},{"name":"get_brandshop_products","description":"通过已知 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，且不得重复原业务调用。","parameters":{"brandshop_id":{"type":"string","required":true,"description":"Amazon Store 页面 /page/ 后的 UUID，或包含该 UUID 的完整 Amazon Store URL。绝不能传 Apple 等品牌名、ASIN 或 Seller ID。","examples":["F2EA1BDC-1CBB-45F8-A05E-EF75A20B8A50"],"minLength":1},"keyword":{"type":"string","required":false,"default":"","description":"可选的店铺内商品筛选词；不是品牌店名称解析参数。"},"limit":{"type":"integer","required":false,"default":10,"description":"本次调用的目标返回上限，范围 1-100；服务会按需跨上游分页，但上游不足、筛选、时间或页数边界可能使结果少于该数量。","minimum":1,"maximum":100},"ai_enhance":{"type":"boolean","required":false,"default":false,"description":"是否允许在无法识别上游结构时使用 AI 解析；通常保持 false。"},"enrich":{"type":"boolean","required":false,"default":false,"description":"高成本开关。false 仅查列表；true 对每个返回 ASIN 再做一次详情查询。每次实际返回并用于交付的列表或详情查询基础价为 1 Credit；空详情不计费。因此 limit=3,enrich=true 最多为 1 次列表 + 3 次有数据详情 = 4 基础 Credits（活动折扣另计）。"},"domain_name":{"type":"string","required":false,"default":"","description":"Amazon 站点域名；当前仅支持美国站 www.amazon.com；德国、日本站已停止支持。省略或传空字符串表示美国站，且必须与 URL/ID 所属站点一致。","enum":["","www.amazon.com"],"examples":["www.amazon.com"]},"cursor":{"type":"string","required":false,"default":"","description":"首轮必须留空；后续逐字回传同一查询的 next_cursor，或已读完后台任务返回的 continuation_cursor；禁止构造、递增、解码或跨查询复用。"}},"example":{"brandshop_id":"F2EA1BDC-1CBB-45F8-A05E-EF75A20B8A50","limit":5,"enrich":true}},{"name":"start_product_review_collection","description":"启动单一平台的商品评论后台采集。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 返回，无需先额外调用它再查询。","parameters":{"item_id":{"type":"string","required":true,"description":"目标平台的标准商品 ID；规则与 get_product_reviews.item_id 相同。","minLength":1},"platform":{"type":"string","required":false,"default":"amazon","description":"本任务唯一的平台/区域。每个任务只能采集一个平台。","enum":["amazon","target","tkshop_us","tkshop_sg","tkshop_vn","tkshop_id","tkshop_th","tkshop_my","tkshop_ph"]},"max_items":{"type":"integer","required":false,"default":5000,"description":"本任务最多保存的评论总数，范围 1-5000；这是目标上限。Amazon 每个 ASIN+星级筛选条件最多 10 页；增大 max_items 不会切换星级或突破该上限。","minimum":1,"maximum":5000},"batch_limit":{"type":"integer","required":false,"default":100,"description":"每个内部同步批次最多交付的评论数，范围 1-100；不是上游 page_size。","minimum":1,"maximum":100},"min_rating":{"type":"integer","required":false,"default":null,"description":"最低评分 1-5；Amazon 单一星级设 min_rating=max_rating；全部星级省略二者。","minimum":1,"maximum":5},"max_rating":{"type":"integer","required":false,"default":null,"description":"最高评分 1-5；Amazon 单一星级设 min_rating=max_rating；不支持多星级区间。","minimum":1,"maximum":5},"verified_only":{"type":"boolean","required":false,"default":false,"description":"仅保留已验证购买；Amazon V2 请省略或传 false，不支持购买验证筛选。"},"sort_by":{"type":"string","required":false,"default":"default","description":"仅支持平台默认顺序，请省略或传 default。整个任务必须保持不变。","enum":["default"],"x-realtrace-platform-capabilities":{"amazon":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"target":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_us":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_sg":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_vn":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_id":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_th":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_my":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true},"tkshop_ph":{"selectable":false,"accepted_values":["default"],"default_order":"platform_default","omit_when_default":true}}},"domain_name":{"type":"string","required":false,"default":"","description":"Amazon 站点域名；当前仅支持美国站 www.amazon.com；德国、日本站已停止支持。省略或传空字符串表示美国站，且必须与 URL/ID 所属站点一致。","enum":["","www.amazon.com"],"examples":["www.amazon.com"]},"on_conflict":{"type":"string","required":false,"default":"ask","description":"发现已有不同任务时的动作。默认 ask 不做破坏性操作并让 Agent 决策；reuse 保留并复用当前任务；queue 严格排在旧任务之后；cancel_previous 请求取消可访问的旧任务后排队；parallel 仅在用户明确要求并行、响应 allowed_actions 包含 parallel 且容量可用时执行。","enum":["ask","reuse","queue","cancel_previous","parallel"]},"force_refresh":{"type":"boolean","required":false,"default":false,"description":"false 时短期内相同已完成任务会复用；true 明确要求重新采集。"}},"example":{"item_id":"B08N5WRWNW","platform":"amazon","max_items":1000,"batch_limit":100,"on_conflict":"ask"}},{"name":"list_collection_tasks","description":"列出当前用户的运行中和排队采集任务，并返回动态 capacity、running_count/queued_count、剩余运行/排队槽位，以及 has_active_task/has_unfinished_task/has_running_task/has_queued_task。当前 Key 无权访问的平台任务只显示非敏感状态。准备启动两个或更多可能转后台的调用前必须先调用；跨平台任务默认逐个提交。状态/控制查询不调用上游、不占普通数据执行槽且不计费。","parameters":{"include_finished":{"type":"boolean","required":false,"default":false,"description":"是否同时返回最近完成、失败和已取消任务。"},"limit":{"type":"integer","required":false,"default":20,"description":"最多返回的任务记录数，范围 1-100。","minimum":1,"maximum":100}},"example":{"include_finished":false,"limit":20}},{"name":"get_collection_task_status","description":"读取或短暂等待一个持久业务任务的状态、进度、target_reached/shortfall/completion_reason 和 allowed_actions；不调用上游且不计费。状态轮询次数取决于进度变化，与内部上游页数无固定关系；不得重复原业务请求。","parameters":{"task_id":{"type":"string","required":true,"description":"业务工具自动返回或 start_product_review_collection 返回的 task_id。","minLength":1,"maxLength":128},"wait_seconds":{"type":"integer","required":false,"default":0,"description":"可选长轮询等待秒数，范围 0-25；有新进度会提前返回。","minimum":0,"maximum":25},"after_version":{"type":"string","required":false,"default":"","description":"上一次 task.progress_version；仅在版本未变化时等待，必须逐字回传。","maxLength":256}},"example":{"task_id":"collect_<task_id>"}},{"name":"cancel_collection_task","description":"协作式取消当前用户中、当前 API Key 有平台权限的采集任务。已发出的上游请求完成后停止，已 checkpoint 的部分结果保留；重复取消幂等且不计费。","parameters":{"task_id":{"type":"string","required":true,"description":"要取消的 task_id。","minLength":1,"maxLength":128}},"example":{"task_id":"collect_<task_id>"}},{"name":"resume_collection_task","description":"从持久 checkpoint 恢复 failed、paused 或 cancelled_partial 任务；不从第一页重来。 首次查询自动检查当前可用性；service_query_unavailable 时停止该平台/功能，遵守 retryable=false，不重试或自动轮询，不建议恢复时间。动态状态随 get_agent_instructions 返回，无需先额外调用它再查询。","parameters":{"task_id":{"type":"string","required":true,"description":"要恢复的 task_id。","minLength":1,"maxLength":128}},"example":{"task_id":"collect_<task_id>"}},{"name":"get_collection_task_result","description":"免费读取已经持久化的采集结果，每次最多 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 只表示所选查询场景结束。","parameters":{"task_id":{"type":"string","required":true,"description":"要读取结果的 task_id。","minLength":1,"maxLength":128},"limit":{"type":"integer","required":false,"default":100,"description":"本次读取的已存储结果上限，范围 1-100。","minimum":1,"maximum":100},"cursor":{"type":"string","required":false,"default":"","description":"首轮留空；后续逐字回传本工具上一响应的 next_cursor。"}},"example":{"task_id":"collect_<task_id>","limit":100,"cursor":""}}]}