CONNECT CCREACH

把 CCReach 接入你的 Agent

让 Agent 按任务查询资料、数据源、工具服务、Agent、技能与工作流，读取候选资源、提供方入口、接入条件、费用及来源，再继续完成用户的任务。

你可以使用远程 MCP，也可以直接接入 HTTP API。CCReach 提供资源发现与比较信息；具体资源的调用、安装和使用，依据提供方说明和用户授权进行。

通过远程 MCP 接入

如果你的 Agent 客户端支持远程 MCP 和 Streamable HTTP，可在它的 MCP 服务设置中添加以下连接信息：

  1. 在客户端中找到添加远程 MCP 服务的入口，填写名称与服务器地址；如需选择传输方式，选择 Streamable HTTP。
  2. 按客户端提示连接服务并读取工具列表。成功连接后，可用工具包括 search_resources、get_resource 和 catalog_info。
  3. 让 Agent 在需要寻找外部信息或能力时查询 CCReach，再结合用户意图和资源条件选择候选。

不同客户端的设置入口和支持范围有所不同。能否调用以及何时调用，由客户端配置和 Agent 的任务判断决定。暂不支持这种远程连接的客户端，可以接入下面的 HTTP API。

三个只读查询工具

search_resources：按任务查找资源

例如，需要寻找论文和研究数据的查询入口，可以向此工具传入：

{
  "query": "论文检索 研究数据",
  "category": "all",
  "kind": "all",
  "protocol": "all",
  "free_only": false,
  "executable_only": false,
  "limit": 8
}

返回候选的名称、用途、类型、接入方式、费用条件、来源和匹配线索。默认使用 all，让 Agent 先比较不同类型的资源；只有明确的用户要求才应提前收窄范围。

查看搜索参数与可选值
  • query：任务需求或关键词，最多 500 个字符；空字符串表示浏览目录。
  • category：任务方向，可选 all、information、data、development、office、media、automation、research、agents。
  • kind：资源类型，可选 all、document、data_source、tool、agent、skill、workflow。
  • protocol：接入方式，可选 all、web、http、mcp、a2a、local。
  • free_only：设为 true 时仅保留有当前有效价格证据的完全免费记录。未知费用和有条件免费额度不会通过此筛选。
  • executable_only：设为 true 时仅保留记录中具备执行接口的资源；接口形态不代表已执行验证或已经取得使用权限。
  • limit：每页条数，范围为 1–50；MCP 工具默认 8 条。
  • page：页码，从 1 开始。翻页时保持查询、筛选和条数不变，并同时传入上次响应中的 snapshot_id 与 result_set_id。若结果版本发生变化，清除两个标识后从第一页重新查询。

get_resource：查看资源详情

选择候选后，将搜索结果中的 id 作为 resource_id，读取提供方文档、条件和核验记录：

{
  "resource_id": "open-meteo"
}

catalog_info：查看可用分类

不需要参数。读取当前支持的任务方向、资源类型、接入方式和目录版本，避免自行猜测筛选值。

{}

通过 HTTP API 接入

HTTP API 使用 HTTPS，返回 JSON 格式的数据。公开的搜索、详情和分类查询无需 CCReach 账号或 API 密钥。

例如，用任务描述或关键词查询候选资源：

GET https://ccreach.com/api/search?q=paper&category=all&kind=all&protocol=all&free_only=false&executable_only=false&limit=8

查询文本需要进行 URL 编码；分页条件与上面的 MCP 搜索工具相同。完整参数和返回字段见 CCReach API 文档。

怎样让 Agent 查得更合适？

检索综合关键词与任务语义，并应用明确的筛选条件。结果是供比较的候选；Agent 应结合原始任务继续判断适用性。

给开发者的进一步说明

HTTP 参数与响应可查看 API 文档。远程 MCP 的传输协议可查看 MCP 官方 Streamable HTTP 规范；客户端应按其支持的协议版本处理连接和工具调用。

本地运行本项目的开发者，也可以使用 stdio MCP，由客户端启动项目中的 MCP 服务进程。

在网页中搜索资源