SuperAPI AI 工具集

metacpan

编程与开发

查看项目

更新于 10-16 09:18

技能介绍

Metacpan 是 Unbrowse 为 AI 智能体提供的一套作用域工具,用于在 metacpan.org 上执行搜索操作。该服务为非官方产品,与 metacpan.org 无隶属或背书关系。

【用途】 让智能体能够以工具调用的方式搜索 metacpan.org(CPAN 模块检索站点)。Unbrowse 从 metacpan.org 自身发出的请求编译出这些工具,每次调用在服务端重放站点的一手 API,并返回经过验证的结果;不抓取渲染后的页面,用户侧不需要浏览器,也不需要 metacpan.org 的 API 密钥。

【主要能力】 核心工具为 metacpan_org__get_search,用于搜索 metacpan.org。其输入包括:query(字符串,必填,即搜索框“Search the CPAN”中输入的查询内容);size(整数,可选,例如 "20");select(数组,可选,用于只保留结果中的指定部分,路径以点号遍历键,[] 遍历列表,末尾 {a,b} 保留多个键,例如 "results[].{title,url}",未匹配的路径会出现在 selectMissing 中)。返回页面标题、可读文本和链接,对 metacpan.org 为只读操作。此外还提供若干通用工具:unbrowse.run(用自然语言描述在 metacpan.org 上的任务)、unbrowse.inspect、unbrowse.resume、unbrowse.scrape、unbrowse.map,以及录制的云端浏览器流程 unbrowse.browse.open → unbrowse.browse.act → unbrowse.browse.finish。在不支持带点名称的主机上,这些工具以 _ 形式显示,如 unbrowse_run。

【使用方式】 通过 MCP 连接: claude mcp add --transport http metacpan https://unbrowse.ai/mcp/metacpan.org codex mcp add metacpan --url https://unbrowse.ai/mcp/metacpan.org && codex mcp login metacpan JSON 配置:{"mcpServers":{"metacpan":{"url":"https://unbrowse.ai/mcp/metacpan.org"}}} 该服务器是仅持有 metacpan.org 的工具作用域,包含编译好的工具及运行它们的 Unbrowse 工具,因此智能体的工具列表保持精简,且每次调用都停留在 metacpan.org 上。首次连接会通过 OAuth 登录 Unbrowse(免费层,仅验证通过的结果计入)。脚本场景可发送 Authorization: Bearer $UNBROWSE_API_KEY(密钥来自 https://unbrowse.ai/app/keys,应保存在密钥管理器中,切勿写入提交的配置)。 调用时选择标题与任务匹配的工具并传入其输入;除用户明确要求其可控制的参数外,不要传入站点记录的参数。读取状态:succeeded 表示带有验证结果;input_required 不是失败,可用 unbrowse.resume {runId, answers} 在同一运行中补充开放字段。若无匹配工具,使用 unbrowse.run {task};当尚无编译能力时会以 no_capability 失败,此时可在 metacpan.org 上执行一次 unbrowse.browse.open → unbrowse.browse.act → unbrowse.browse.finish,从而编译出下次列出的新工具。任何超出 metacpan.org 范围的请求会被拒绝(not_in_scope),应改用通用 Unbrowse 服务器。登录时绝不要向用户索要密码;unbrowse.browse.act 使用 action: "autofill" 可从用户的 Unbrowse 密码管理器填充 metacpan.org 登录信息。只报告 succeeded 结果所述内容;outcome_unknown 表示可能已发生变更,重试前应先检查;发布、购买、发送或删除操作需用户批准。 不使用 MCP 时,每个工具也可作为 REST 调用: curl -s https://unbrowse.ai/api/v1/sites/metacpan.org/call/metacpan_org__get_search
-H "authorization: Bearer $UNBROWSE_API_KEY" -H "content-type: application/json"
-d '{"query":"<query>"}' OpenAPI 位于 https://unbrowse.ai/api/v1/sites/metacpan.org/openapi.json。

【适用场景】 需要在智能体工作流中检索 CPAN 模块信息、以工具调用方式完成 metacpan.org 搜索,或希望以受控作用域把请求限制在 metacpan.org 上时使用。

【限制】 非官方服务,与 metacpan.org 无隶属或背书关系;仅限 metacpan.org 范围,超出范围的请求会被拒绝;依赖 Unbrowse 账号(首次连接需 OAuth 登录,脚本需 API 密钥);若工具不在当前会话的工具列表中,表示服务器未连接或未登录,此时应说明并停止,不得改用其他方式抓取 metacpan.org 并当作本技能结果;发布、购买、发送或删除类操作需用户批准。价格、收费与更多功能细节资料暂未提供。