安装 Skill
从公开仓库将 SocQ Skill 添加到兼容的 AI 编码客户端。
npx skills add SocQAPI/socq-devtools专为 AI Agent 打造的公开社交数据研究 Skill.
无需改变现有 MCP 配置。安装一个 Skill，让 Agent 更准确地选择 Endpoint、控制成本，并可靠完成异步任务、分页和跨平台研究。
一个 Skill 覆盖完整 SocQ API 目录12 个已支持平台92 项 API 能力
快速开始
三步启用 Skill，让 Agent 开始完整研究
安装 SocQ Skill、安全配置 API Key，再用自然语言描述研究目标；Agent 会按 Skill 方法选择 Endpoint、执行任务、完成分页并整理最终分析。
配置 API Key
将 API Key 安全保存在本地环境变量中，为实时 SocQ 任务提供认证。
SOCQ_API_KEY描述研究任务
直接使用自然语言。Skill 会指导 Endpoint 选择、执行、轮询、分页和结果整理。
比较这三个 X 账号最近发布的内容。不要把 API Key 粘贴到公开对话、代码仓库或共享文档中。请按照对应客户端指南完成安全的本地配置。
查看完整安装指南MCP And MCP + Skill
MCP 和 MCP + Skill 的区别
MCP 让 Agent 直接调用 SocQ 的公开社交数据工具；安装 Skill 后，Agent 还能更准确地选择 Endpoint、预估成本、持续完成异步任务与分页，并用一致的方法开展跨平台研究。
只使用 MCP
直接使用 SocQ 实时工具
MCP 已经可以让 Agent 发现 Endpoint、提交采集任务、查看任务状态并读取结果。
- 用明确输入调用已知 API
- 提交并读取简单采集任务
- 由模型临场决定周边工作流
适合 Endpoint 明确、流程简单的一次性采集。
MCP + Agent Skill
相同工具，加上一套可靠研究方法
Skill 教 Agent 如何选择、组合和恢复 SocQ 操作，但不会增加另一套数据服务。
- 将模糊目标映射到正确 Endpoint
- 在大任务前检查 Schema 和成本
- 安全完成轮询、分页、重试和统一输出
适合多步骤、高成本、异步、重复或跨平台研究。
| 任务 | 只使用 MCP | MCP + Skill |
|---|---|---|
| 调用已知 Endpoint | 直接调用工具并读取结果 | 先校验输入，再按统一流程执行并整理结果 |
| 将研究目标拆成 API 步骤 | 由 Agent 临场选择 Endpoint 和执行顺序 | 按固定方法拆解目标、选择 Endpoint 并规划步骤 |
| 执行大型异步采集 | 由 Agent 自行处理成本、任务状态和分页 | 执行前预估成本，持续查询原任务并完整读取分页 |
| 开展跨平台比较 | 由 Agent 临场确定各平台的采集与比较口径 | 统一数据量、采集步骤和输出结构，让结果直接可比 |
如果你只调用几个定义清楚的 SocQ API，MCP 已经足够；当你希望 Agent 独立完成多步骤、异步或跨平台研究时，再安装 Skill。
了解 SocQ MCPSkill 教会 Agent 什么
让 Agent 从研究目标稳定走到完整结果
SocQ Skill 为 Endpoint 选择、输入校验、成本预估、异步任务、分页和异常恢复提供一套可靠方法，让公开社交数据研究更准确、更高效、更可复用。
选择正确能力
将自然语言目标映射到 SocQ Capability Registry 中对应的 Endpoint。
组织有效输入
判断任务需要 URL、用户名、标签、搜索词还是其他文档规定的输入。
控制任务成本
在提交大型采集任务前检查能力说明并预估积分。
完成异步任务
持续查询原任务，而不是重复提交并可能产生两次费用。
处理分页和文件
读取游标分页结果，并在工作流需要时获取原始结果文件。
恢复失败流程
根据认证、参数、频率、额度和服务商错误选择正确的下一步。
研究任务示例
描述研究目标，让 Skill 规划完整流程
每个示例都从业务目标出发，由 Skill 选择 Endpoint、校验输入、控制成本、完成异步任务与分页，并把结果整理成可直接使用的分析。
Instagram Posts API
使用: instagram/postsTikTok Search API
使用: tiktok/searchTwitter Search API
使用: x/searchYouTube Search API
使用: youtube/searchLinkedIn Profiles API
使用: linkedin/profilesReddit Posts API
使用: reddit/posts理解研究目标
识别对象、平台、时间范围、结果数量和期望输出。
选择 Endpoint
把任务匹配到当前 SocQ Capability Registry。
检查输入与成本
在大型任务前检查 Schema、参数限制和预估积分。
执行数据采集
优先使用 MCP，并在提交时传递 Skill 来源标记。
继续原任务
查询返回的 task_id，而不是创建重复采集。
读取所需结果
跟随游标分页，并在需要时获取文件。
整理最终答案
输出可比较的表格、总结、证据或结构化结果，而不是原始 Endpoint 术语。
执行优先级
托管 MCP → SocQ stdio bridge → MCP 不可用时回退到 CLI 或 REST。
为什么选择 SocQ Agent Skill
让 Agent 用可靠方法完成公开社交数据研究
SocQ Agent Skill 与实时 Capability Registry 保持一致，帮助 Agent 准确选择 Endpoint、持续完成异步任务、规划成本，并用统一口径开展跨平台比较。
01
与 Capability Registry 保持一致
Endpoint 选择和输入指导引用 MCP 与 API 目录使用的同一份能力来源。
Skill ↔ Capability Registry ↔ MCP02
原生理解异步任务
Agent 知道何时提交、何时等待，以及如何继续查询而不重复执行。
提交 → task_id → 查询 → 结果03
具备成本意识
大型任务可以在消耗积分前先进行检查和规划，并在必要时使用幂等重试。
Schema → 预估 → 执行04
跨平台研究方法
当证据来自不同平台时，使用一致的采集数量和输出结构。
一个目标 → 多个平台 → 可比较结果选择接入方式
你的工作流，应该从哪里接入 SocQ？
MCP、CLI 和 REST 是执行入口，Agent Skill 是增强层。它们共用同一套 API 目录与异步任务模型，能力一致，接入自由。
当前页面 · Agent Skill
让 Agent 用可靠方法完成数据研究
为 Agent 补充 Endpoint 选择、成本控制、分页和任务恢复方法。优先配合 MCP，也可以通过 CLI 或 REST 执行。
- 适合
- 多步骤、异步和跨平台研究
- 使用方式
- Agent Skill + MCP（首选）
- 下一步
- 安装 SocQ Agent Skill
首选执行入口
MCP
连接一次，让 Agent 使用自然语言发现工具、提交采集，并持续读取异步任务结果。
Agent Skill 常见问题
常见问题
SocQ Agent Skill 是什么？
它是一组可复用的工作流说明，教 AI Agent 选择 SocQ Endpoint、组织输入、控制成本、完成异步采集并整理研究结果。
MCP 已经能正常使用，为什么还要安装 Skill？
MCP 解决的是“让 Agent 能调用 SocQ 工具”，Skill 解决的是“让 Agent 能稳定完成完整研究”。安装 Skill 后，Agent 会按一套可复用方法理解目标、选择 Endpoint、校验输入、预估成本、持续完成异步任务和分页，并用统一口径整理跨平台结果。面对多步骤、长耗时或重复研究任务，这套方法可以减少临场判断与重复执行，让结果更稳定、更完整、更容易比较。
Skill 会比 MCP 解锁更多 API 吗？
不会。Skill 不增加另一套数据服务，也不会解锁私有能力；它教 Agent 更可靠地使用同一份 SocQ API 目录。
使用 Skill 必须安装 MCP 吗？
不是。Skill 优先使用托管或 stdio MCP；MCP 不可用时，也可以指导 Agent 使用 SocQ CLI 或 REST API。
SocQ 是一个 Skill，还是每个平台一个 Skill？
SocQ 使用一个跨平台 Skill。Agent 会根据任务从完整 SocQ 目录中选择合适能力。
使用 Skill 是否需要 API Key？
执行实时数据采集需要有效的 SocQ API Key。Skill 本身不应该包含或保存凭证，请在本地客户端环境中安全配置。
Skill 可以处理异步任务和分页吗？
可以。它会指导 Agent 持续查询原任务、跟随结果游标，并在任务需要时获取原始文件。
Skill 可以访问哪些数据？
它可以使用当前 SocQ API 目录已经提供的公开社交数据能力。每个 API 页面都会说明输入方式、公开数据范围和标准化结果字段。