专为 AI Agent 实现跨平台使用公开社交数据的 MCP 服务.
连接一次，Agent 就能发现并调用 SocQ 的公开社交数据 API。
https://api.socq.ai/mcpAgent 调用链
自然语言请求
“采集这个 YouTube 视频最新的 100 条评论，等待任务完成，然后返回评论正文、作者、发布时间和点赞数。”
发现 Endpoint
socq_search_endpoints
socq_describe_endpointsocq_execute
POST /mcp
{ "endpoint": "…", "input": { … } }task_id
202 Accepted
{ "task_id": "…" }socq_get_task
GET /mcp
{ "task_id": "…" }results.items
200 OK
{ "items": [ … ],
"next_cursor": "…" }托管 MCP 端点
https://api.socq.ai/mcpTransport: Streamable HTTP
配置方法
选择 Agent 需要看到的 API 范围和使用的客户端，页面会根据当前 SocQ 平台与 Endpoint 注册表生成可直接复制的配置。
将 API Key 保存在环境变量中，Codex 直接连接 SocQ 托管的 Streamable HTTP 地址。
客户端
~/.codex/config.toml配置[mcp_servers.socq]url = "https://api.socq.ai/mcp"bearer_token_env_var = "SOCQ_API_KEY"tool_timeout_sec = 45使用 SocQ MCP，Agent 能做什么？
直接用自然语言提出任务。Agent 会选择匹配能力、读取输入要求、提交采集，并在任务完成后整理标准化结果。
对应能力: youtube/comments对应能力: x/search对应能力: facebook-ad-library/search对应能力: linkedin/jobs对应能力: tiktok-shop/search对应能力: instagram/postsAI Agent 如何调用 SocQ MCP？
MCP 客户端会自动处理协议交互。你只需描述数据需求，Agent 会发现或选择工具、提交采集，并持续读取同一个任务，直到结果可用。
查看完整 MCP 工作流程提出数据需求
用自然语言描述公开社交数据任务，包括平台、数据来源和希望得到的结果。
用户自然语言请求发现或选择工具
自动发现模式会搜索能力注册表；按平台和精确工具模式可以直接调用类型化工具。
socq_search_endpoints → socq_describe_endpoint提交采集任务
SocQ 校验业务输入，创建异步采集任务，并返回对应的任务标识。
socq_execute → task_id读取并整理结果
Agent 继续查询同一个任务，读取标准化分页结果，并按用户要求整理答案。
socq_get_task → results.items专为 AI Agent 跨平台公开社交数据任务而设计
通过一个 MCP 连接，Agent 即可发现并调用跨平台 API，按任务控制工具上下文，并持续查询异步采集结果，无需为每个平台重复接入。
一个连接覆盖完整目录
自动发现模式让 Agent 搜索并执行 SocQ API 目录，不需要为每个平台分别配置 MCP Server。
/mcp → 搜索 → 描述 → 执行控制工具上下文
随着工作流变得明确，可以在自动发现、指定平台和精确类型化工具之间切换。
compact | platforms≤5 | tools≤30适配真实异步采集
Agent 可以继续原任务、读取游标分页的标准化结果和文件，不需要重复提交采集。
task_id → 状态 → results.items → next_cursor你的工作流，应该从哪里接入 SocQ？
MCP、CLI 和 REST 是执行入口，Agent Skill 是增强层。它们共用同一套 API 目录与异步任务模型，能力一致，接入自由。
让 AI 客户端直接调用 SocQ
连接一次，让 Agent 使用自然语言发现工具、提交采集，并持续读取异步任务结果。
- 适合
- AI 客户端和编程 Agent
- 使用方式
- 自然语言 + MCP 工具调用
- 下一步
- 配置 SocQ MCP
推荐搭配 · Agent 增强层
Agent Skill
为 Agent 补充 Endpoint 选择、成本控制、分页和任务恢复方法。优先配合 MCP，也可以通过 CLI 或 REST 执行。
常见问题
SocQ MCP Server 是什么？
它是连接 AI 客户端与 SocQ API 目录的托管 MCP 服务。连接后，Agent 可以发现可用能力、提交公开社交数据采集任务，并读取任务结果。
如何把 SocQ 添加到 Codex、Claude、Cursor 或 VS Code？
Codex 可以直接连接托管 Streamable HTTP 地址。Claude Desktop、Cursor 和 VS Code 可以运行 @socq/mcp stdio bridge。复制上方对应配置，提供 SOCQ_API_KEY，然后重新连接客户端即可。
一个 MCP URL 是不是只对应一个 API？
不是。默认地址通过 Endpoint ID 发现并执行完整 SocQ 能力目录；平台和精确工具模式则把指定能力直接暴露为类型化工具。
为什么默认不把每个 API 都暴露成独立工具？
默认紧凑模式只在需要时搜索和描述具体 Endpoint，避免一次加载全部 Schema，从而减少模型上下文占用，并让工具选择更稳定。
没有 API Key 可以使用吗？
平台、Endpoint 和 Schema 发现可以公开访问。执行采集、查询账户、读取任务结果和下载文件需要有效的 SocQ API Key。
为什么采集任务不是立即返回全部结果？
SocQ 的数据采集是异步任务。提交后会返回 task_id，并可选择等待最多 30 秒；任务仍在运行时，Agent 会继续通过 socq_get_task 查询，而不是重复提交。
MCP 与 REST API 有什么区别？
两者使用相同的能力定义、业务输入、计费规则、限制和异步任务模型。MCP 额外提供工具发现和结构化调用，让 AI 客户端不必自行编写 HTTP 集成。
使用 MCP 如何计费？
MCP 不改变具体 Endpoint 的计费方式。执行采集时沿用与 REST 相同的积分、API Key 限制和账户规则；发现工具本身不提交采集任务。
Agent 可以访问哪些数据？
Agent 只能调用 SocQ API 目录已经提供的公开社交数据能力。每个 API 页面都会说明支持的输入、公开数据范围和标准化结果字段。