从市场发现到口碑追踪，一张图看懂 RealTrace MCP

电商研究search_products

商品搜索与市场扫描

按关键词批量发现商品，用于市场摸底、候选品池建立和跨平台供给对比。不提供 sort_by，使用各电商平台默认顺序。

Amazon · Walmart · Target · TikTok Shop 七区

需要提供

搜索关键词目标平台返回数量Amazon 站点翻页位置

可以获得

商品编号商品标题价格品牌/店铺评分与评论数商品图片商品链接下一页位置

电商研究get_product_details

商品详情与卖点拆解

查看单个商品的完整页面信息，支持竞品档案、价格对比、卖点和规格分析。

Amazon · Walmart · Target · TikTok Shop 七区

需要提供

商品编号所属平台Amazon 站点

可以获得

标题与品牌售价/原价优惠信息评分与评论数销量信息图片集类目卖点与规格商品变体店铺/卖家

评论口碑get_product_reviews

商品评论与用户反馈

一次业务请求内部按游标获取目标数量；Amazon 支持精确星级、购买验证和 default/hot/newest 排序。不自动发散或跨查询去重。

Amazon · Target · TikTok Shop 七区

需要提供

商品编号所属平台评论数量评分范围仅验证购买翻页位置

可以获得

评论编号评论标题/正文评分评论用户评论时间购买验证有用数下一页位置

店铺研究get_shop_info

TikTok Shop 店铺画像

从店铺内任一在售商品定位店铺，补齐店铺身份和公开经营信息。

TikTok Shop 美国、新加坡、越南、印尼、泰国、马来西亚、菲律宾

需要提供

店铺内商品编号所属国家/地区

可以获得

店铺名称店铺编号卖家资料国家/地区店铺评分公开经营指标

趋势榜单get_rankings

Amazon 畅销榜追踪

读取指定类目的 BSR 畅销榜，发现头部商品、排名结构和类目竞争格局。不提供 sort_by，按 Amazon BSR 榜单排名顺序返回。

Amazon

需要提供

榜单类目网址返回数量翻页位置

可以获得

榜单排名商品编号商品标题价格评分与评论数图片与链接下一页位置

品牌研究get_brandshop_products

Amazon 品牌店商品盘点

盘点品牌旗舰店商品矩阵，可按词筛选并选择是否补充逐商品详情。不提供 sort_by，使用 Amazon Store 默认顺序。

Amazon

需要提供

品牌店编号店内关键词返回数量是否补充详情Amazon 站点翻页位置

可以获得

商品清单商品编号标题与价格图片与链接详情补充结果下一页位置

内容发现search_posts

社媒帖子与视频搜索

围绕品牌、品类或话题发现公开内容。每次调用只访问一个平台；跨平台研究由 Agent 分别调用后汇总。

TikTok · YouTube · Reddit · Facebook · Instagram · X

需要提供

搜索关键词只含一个键的 platforms 对象平台内 limit/content_typeYouTube：sort_by=relevance/newest/rating/viewCountFacebook/X：sort_by=relevance/newestTikTok/Instagram/Reddit：不传 sort_by该平台 cursor

可以获得

内容编号标题/文案内容链接发布账号发布时间播放/点赞/评论/分享评论入口编号下一页位置

内容分析get_post_details

帖子与视频详情

深入查看单条公开内容，补齐正文、作者、互动指标和后续评论采集入口。

TikTok · YouTube · Reddit · Facebook · Instagram

需要提供

帖子/视频网址所属平台

可以获得

内容编号标题/正文作者信息发布时间互动指标图片/视频信息评论入口编号

评论口碑get_social_comments

社媒评论采集

采集帖子或视频下的公开评论，用于口碑判断、需求洞察和风险信号识别。

TikTok · YouTube · Reddit · Facebook · Instagram · X · LinkedIn

需要提供

评论入口编号所属平台内容类型评论数量Reddit：sort_by=default/newest/best/top（省略默认 newest）其他平台：省略 sort_by，使用平台默认顺序翻页位置

可以获得

评论编号评论正文评论者编号/名称评论时间点赞数回复数下一页位置

讨论追踪get_comment_replies

评论回复与对话链

继续展开重点评论下的回复，理解争议脉络、品牌回应和用户之间的真实讨论。不提供 sort_by，使用各社媒平台默认顺序。

Facebook · Reddit · YouTube

需要提供

评论编号所属平台YouTube 视频编号回复数量翻页位置

可以获得

回复编号回复正文回复者编号/名称回复时间点赞数下一页位置

创作者画像get_creator_info

账号与创作者档案

补齐达人或账号的公开档案和影响力指标，支持达人筛选、竞品账号研究与账号建库。

TikTok · YouTube · Reddit · Facebook · Instagram · X · LinkedIn

需要提供

平台标准账号编号所属平台

可以获得

标准账号编号账号名/显示名账号简介头像粉丝/关注数内容数量累计互动指标

账号监控get_creator_posts

账号发布内容追踪

按标准账号编号持续获取发布内容，用于品牌矩阵、竞品账号和达人内容更新监控。不提供 sort_by，使用各社媒平台默认顺序。

TikTok · YouTube · Facebook · Instagram · X · LinkedIn

需要提供

所属平台标准账号编号Facebook 主页网址内容类型返回数量翻页位置

可以获得

内容编号内容网址标题/文案发布时间图片/视频信息互动指标下一页位置

内容理解get_captions

视频字幕提取

提取公开视频的字幕文本，为内容总结、主题归纳、话术拆解和多视频对比提供基础。

YouTube

需要提供

视频网址/视频编号所属平台

可以获得

字幕全文字幕分段时间信息视频编号语言信息

长任务start_product_review_collection

断线安全的全量评论采集

启动单平台后台任务；相同参数自动复用，不同任务由 Agent 明确选择复用、排队、取消旧任务或并行。

Amazon · Target · TikTok Shop 七区

需要提供

商品编号单一平台最多总条数每批最多 100冲突动作

可以获得

任务编号排队位置冲突选项断线续跑

任务可见性list_collection_tasks

查看运行与排队任务

开始新任务前查看当前用户是否已有工作，供 Agent 判断复用、排队、取消或并行。

不发起数据查询 · 不计费

需要提供

是否含已结束任务返回上限

可以获得

运行数量排队数量任务状态Key 可访问性

任务进度get_collection_task_status

断线后恢复任务上下文

通过 task_id 读取进度、是否达到目标、短缺原因与当前可执行动作；轮询次数不对应数据页数。

不发起数据查询 · 不计费

需要提供

任务编号

可以获得

当前状态已采集数量已完成批次可执行动作

任务控制cancel_collection_task

协作式取消旧任务

停止继续采集，保留已 checkpoint 的结果；已发出的当前批次结束后生效。

幂等 · 不发起数据查询 · 不计费

需要提供

任务编号

可以获得

取消状态部分结果保留

任务恢复resume_collection_task

从 checkpoint 恢复采集

恢复失败、暂停或已取消的任务，从上次游标继续而不是从第一页重抓。

不发起数据查询 · 不计费

需要提供

任务编号

可以获得

重新排队状态既有进度

结果读取get_collection_task_result

免费分页读取已存评论

每次读取最多 100 条已存结果；100 条最多一次读取。读完与拿够分别看 all_results_read 和 target_reached。

每次最多 100 条 · 不发起数据查询 · 不计费

需要提供

任务编号读取上限结果游标

可以获得

评论明细任务进度是否完整下一页游标

智能协作get_agent_instructions

V14 分层调用契约

首次读取短索引，再按当前任务读取 core 与一个业务层；批量取数只追加 more_data 和一个 more_* 层，避免一次塞入全部范例。

index · core · 按任务/批量目标读取

需要提供

section（首次 index）

可以获得

分层阅读索引工具链契约平台 ID 规则后台任务协议分页与错误恢复Credits 规则