API 参考
六个动作，一套约定
核心输入、响应结构、翻页方式和 Remote MCP 约定。
选择动作
search：查询公开内容或用户。可选一个平台，或显式列出最多五个平台；count 为 1–20。多平台调用不能带 cursor。
trending：选择平台和可选的受支持分类。有的平台返回内容条目，有的返回榜单。
detail 和 comments：传入 platform 和 url_or_id。comments 可带 cursor 和 reply_of。
user_profile 和 user_posts：传入 platform 和 user。创作者作品可带 cursor。各平台接受的账号标识不同。
读懂响应结构
每个响应都包含 request_id、schema_version 和 fetched_at。单平台结果包含 platform、status、items、applied_params 和 warnings。多平台搜索把结果放在 fanout 下，并在 billing.detail 中逐项列出费用。
MCP 的 structuredContent 与 JSON 文本内容是同一份结构。not_supported 是业务结果，不是传输错误。即使外层 status 为 ok，也要逐个检查 fanout 中的每一格。
{
"request_id": "example_only_not_a_live_call",
"schema_version": "v1",
"fetched_at": "2026-09-05T00:00:00Z",
"status": "ok",
"applied_params": {},
"warnings": [],
"items": [
{
"kind": "item",
"id": "EXAMPLE_ITEM_ID",
"author": {
"name": "example_author"
},
"published_at": "2026-09-01T08:30:00Z",
"metrics": {
"likes": 412,
"comments": 96
},
"title": "Illustrative post title",
"text": "Illustrative excerpt, not real content."
}
],
"platform": "reddit",
"billing": {
"cost": 0.2,
"balance": 1.8,
"unit": "credits",
"pricing": "standard"
}
}翻页令牌保持不透明
cursor 绑定工作区、平台、动作和规范化后的查询，30 分钟后过期。不要解析、修改 cursor，也不要挪到其他请求使用。cursor 只对单个平台有效。
当 has_more 为 false，或页数、credit 预算用完时停止。原生不支持的筛选必须在你的解释中如实说明。展开回复分支前，请先查看该平台的限制。
只调用你的 Key 能用的能力
默认连接器提供六个核心动作和 capabilities。受限权限集中不包含 account 和 ping 工具；第一次付费调用前请在控制台查看余额。额外权限和扩展包不会因为加了 URL 参数而被授予。Raw 和扩展包的可用性须在使用前明确记录在文档中。
GET 和 POST 共用 /v1/ 下的核心路径。产品 Key 支持 X-API-Key、Bearer 或 key 查询参数鉴权；控制台路由改用登录用户的会话。