关于 Bowmark AI
Bowmark AI 为 Agent 提供预先编制的网站导航配方,可通过短 JavaScript 脚本操作实时网站。项目包含技能和 MCP 服务,并提供 Claude Code 与 Codex 插件安装方式。
主要功能
- 01读取类型化函数库
- 02在实时网站运行 JavaScript 脚本
- 03报告失败或错误的运行结果
- 04以技能或插件形式安装
适用场景
- 01查询任务所需的网站函数
- 02在实时网站执行准备好的操作
- 03反馈失败结果
MCP 相关
该技能调用 Bowmark 的 MCP 服务,后者提供 `get_library`、`run` 和 `report` 工具。同一函数库查询和执行能力也可通过 HTTP 使用。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.bowmark.ai/mcp/registryclaude mcp add --transport http skill https://api.bowmark.ai/mcp/registry{"mcpServers":{"skill":{"type":"http","url":"https://api.bowmark.ai/mcp/registry"}}}在 Cursor 中打开{"servers":{"skill":{"type":"http","url":"https://api.bowmark.ai/mcp/registry"}}}在 VS Code 中打开{"mcpServers":{"skill":{"type":"http","url":"https://api.bowmark.ai/mcp/registry"}}}{"mcpServers":{"skill":{"serverUrl":"https://api.bowmark.ai/mcp/registry"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://api.bowmark.ai/mcp/registry需要授权工具
3| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| query | string | 否 | 可选,但请传入该参数——它决定返回多少详细信息。用用户自己的话描述想要执行的操作("flights"、"price a GPU"、"book a table"、"check stock"),或者传入用户提及的公司/网站("Kayak"、"newegg.com")。粗略猜测始终安全:没有匹配项时会返回一行索引,而不是错误;省略该参数时也一样。 |
详细介绍
bowmark 技能
LM Studio — GitHub 会移除原始的 lmstudio: 链接,因此这里提供的是需要粘贴的内容,而不是按钮。请将其复制到浏览器的地址栏:
lmstudio://add_mcp?name=bowmark&config=eyJ1cmwiOiJodHRwczovL2FwaS5ib3dtYXJrLmFpL21jcC9iYWRnZS1sbXN0dWRpbyJ9
适用于 Bowmark 的技能——将 Web 变成可调用的函数。Agent 会读取一个类型化函数库,针对该库编写简短脚本,然后由 Bowmark 在实时网站上运行。
npx skills add bowmark-ai/skill
适用于任何支持 SKILL.md 标准的宿主——Claude Code、Codex(原生采用了该标准)、Cursor、GitHub Copilot、OpenCode 等。
该技能会调用 Bowmark 的 MCP 服务——可通过 bowmark.ai/#install 或 Smithery 进行配置。
想一步完成两者的安装? 在 Claude Code 和 Codex 上,请改为安装插件——它包含此技能,并且会自动配置 MCP:
# Claude Code
claude plugin marketplace add bowmark-ai/plugin && claude plugin install bowmark@bowmark-ai
# Codex
codex plugin marketplace add bowmark-ai/plugin # then `codex /plugins` to install
工具
| 工具 | 功能 |
|---|---|
get_library | 读取针对任务或网站的类型化函数库。此操作为只读,不会访问任何网站;如果查询无法识别,则返回索引而非错误。 |
run | 针对实时网站执行简短的异步 JavaScript 脚本,并返回 { ok, result, logs, error, ms }。 |
report | 告知 Bowmark 它无法完成的操作,或指出哪次运行结果有误。反馈会被记录;不会重试任何操作。 |
没有 MCP 客户端? 同样的两个调用也可通过纯 HTTP 完成——GET https://api.bowmark.ai/v1/library?query=… 和 POST https://api.bowmark.ai/v1/run,两者都需要 Authorization: Bearer $BOWMARK_API_KEY。参考文档见 bowmark.ai/docs/api;示例见 bowmark.ai/docs/scripting#no-install-at-all。
OpenAI Apps(ChatGPT 插件)变体
ChatGPT Apps 提交时需要提供一个技能,格式为 ZIP 或文件夹,其需求与通用技能略有不同:插件始终会将 MCP 与技能一同打包,而 ChatGPT 会以纯名称形式公开工具。因此,我们提供了一个定制变体,由同一个规范技能生成,绝不手动维护:
- 文件夹:
openai/bowmark/—bowmark/SKILL.md的内容镜像,删去了末尾的“Your API key”部分及其后的所有内容(ChatGPT 通过 OAuth 登录,无法发送密钥),将工具名称改写为纯名称get_library/run,删去了仅适用于 Claude 的 frontmatter/工具名称引用,并将三个机密工具(list_secrets、request_secret、get_secret_link)替换为仪表板——该插件的 MCP 是 ChatGPT 目录连接器,不提供这些工具。如果规范文本被移出预期位置,此步骤会拒绝构建。build-openai.mjs决定删减哪些内容;此处曾描述bowmark/SKILL.md中从未存在过的章节,导致一位新成员找不到它。 - ZIP:
openai/bowmark-openai-skill.zip— 同一文件夹的 ZIP 压缩包,可直接上传到 ChatGPT“Skills”上传器。这是一个已提交的构建产物(不会在 CI 中构建:发布运行器没有zip二进制文件),因此它会与镜像一起发布到bowmark-ai/skill,并使用与其他文件一样稳定的原始 URL。
两者均由 build-openai.mjs 生成。编辑 bowmark/SKILL.md 后,重新生成并提交——绝不要直接编辑 openai/ 副本(如果文本镜像已过期,CI 的 check:openai 会使 PR 检查失败):
pnpm -F @bowmark/skill sync:openai # regenerate openai/bowmark/SKILL.md
pnpm -F @bowmark/skill build:openai-zip # rebuild openai/bowmark-openai-skill.zip (commit it)
许可证
MIT © Bowmark AI
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。