Skip to main content

​
选择 MCP 工具

SocQ 为开放式调研提供精简工具集（Compact），也为已知平台或 API 端点提供类型化工具（Typed tools）。通过过滤条件可以控制客户端加载哪些工具及其参数结构，从而减少上下文占用，让工具选择更准确。

​
选择一种模式

如果不确定该使用哪个 API，请从精简模式开始。如果应用始终采集同一种数据，请使用精确工具模式。

​
精简模式（Compact）

连接到：
客户端先查找合适的 API 端点，再通过 socq_execute 提交任务：
当客户端需要通过 socq_search_endpoints 和 socq_describe_endpoint 在多种数据采集能力中做选择时，请使用此模式。

​
平台模式

选择一到五个以逗号分隔的平台段：
这会加载相应平台的类型化工具，例如：
平台标识与 API 路径的第一段一致，例如 youtube、tiktok 和 facebook-ad-library。

​
精确工具模式

选择一到三十个以逗号分隔的工具标识符，不带 socq_ 前缀：
使用 tools=youtube_comments 后，客户端只会加载：
使用 API 输入字段直接调用类型化工具：
类型化工具还提供 4 个可选控制字段： 这些与 results_limit 等业务输入是分开的。例如，results_limit: 100 请求最多采集 100 条评论，而 _result_limit: 25 将当前响应页面限制为 25 条记录。

​
命名规则

映射是确定性的：

​
限制

  • platforms 和 tools 不能组合在同一 URL 中。
  • 平台模式最多接受五个平台。
  • 精确工具模式最多接受三十个工具。
  • 过滤仅更改工具可见性。身份验证、产品可用性、计费、API 密钥限制和异步任务行为保持不变。
  • 更改过滤器后重新连接或重新启动客户端，以便刷新 tools/list。
要验证已过滤的连接，请要求客户端列出其 SocQ 工具，然后运行一个小型采集并确认 socq_get_task 可以读取返回的任务 ID。