概览
为海外市场做选题时,仅知道自己熟悉的主题还不够,也需要了解当地此刻正在讨论什么。这份数据把一个地区的话题榜整理为结构化清单,便于快速比较话题名称和榜单位置,建立当天的选题参考。
结果保留原语言,适合作为媒体编辑、内容团队或区域市场研究的原始材料。榜单给出的是讨论入口,是否与品牌、受众和业务有关,仍需要阅读相关内容后判断。
数据说明
数据来自 X 指定地区的当前话题榜,同次结果按话题名称去重,保留返回顺序和排名。排名反映本次榜单的位置,不能理解为全体用户的偏好或商业购买需求。
「检索词」是对应话题的检索入口文字,有时会带话题标签或组合表达;它不是讨论数量、浏览量或热度得分。相同话题在不同地区的排名可能不同,跨地区比较时应保留各次选择的地区和采集时间。
本数据不包含历史榜单或排名变化,无法仅凭一次结果判断话题正在上涨还是下降。没有出现在榜单中,也不等于该地区没有讨论;地区可得性和榜单内容会随来源变化,不补造缺失话题。
结果长什么样
每条记录代表本次榜单中的一个话题。以下为公开数据的采样示例,指标与排名是采样时的快照。
| 话题名称 | 榜单排名 | 检索词 |
|---|---|---|
| Luka | 1 | Luka |
| Lakers | 2 | Lakers |
话题名称和检索词可能相同,也可能使用不同的表达方式。
应用场景
- 整理区域市场选题时,先根据「话题名称」判断相关性,再用「榜单排名」安排需要进一步了解的内容。
- 比较不同地区的讨论入口时,将同一时段取得的「话题名称」「检索词」放在一起,辨认共同话题与地区差异。
- 建立每日选题记录时,保留「榜单排名」和「话题名称」,结合自行保存的地区、时间信息进行后续人工复盘。
适用边界
每次查询全球或清单内 62 个国家、地区之一的当前榜单,申请最多 30 个话题,实际可能更少;不含城市选择、历史榜单、发帖数量或排名走势。
- 适合用于
- 需要获取目标市场当前热门话题,作为选题或研究入口时。
- 不要用于
- 需要历史热榜、讨论数量、热度走势或城市榜单时。
- 需要判断某个话题的观点或消费者购买意图时。
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1空结果只表示本次没有可返回的榜单,不等同于当地没有讨论。
- 2先确认地区选择;鉴权或额度问题由发布者处理,限流后暂停,不连续重试。
- 3比较多次榜单时自行保留地区及采集时间,不把重复话题当新增讨论。
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 热榜地区
region必填string(enum)选择全球或清单内的国家、地区,获取其当前话题榜;部分地区可能暂时没有可返回的数据,不包含历史走势。可选值常用 1(全球) / 23424977(美国) / 23424856(日本) / 23424975(英国) / 23424948(新加坡) / 23424848(印度) / 23424868(韩国) / 23424748(澳大利亚) / 23424775(加拿大) / 23424960(泰国) / 23424846(印度尼西亚) / 23424901(马来西亚) …(共 63 项,试运行表单可搜索)示例23424977
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 话题名称
topicstring当前榜单中的话题名称,保留原有语言。示例Luka - 榜单排名
rankinteger该话题在本次地区榜单中的名次,1 为第一名。示例1 - 检索词
search_querystring该话题对应的检索词,不代表帖子数量或热度分值。示例Luka
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"topic": "Luka",
"rank": 1,
"search_query": "Luka"
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=frank9306/x-region-trends",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。
默认列出 12 个常用值,输入可搜索全部 63 项