本页内容
Smithery 是规模最大的 MCP server 注册表,为 AI agent 托管了超过 100,000 个工具和集成。CrawlForge 已上架 Smithery,这意味着你无需手动修改配置文件,即可发现、安装并管理你的 web scraping MCP server。
本指南将带你走完完整的 Smithery 工作流——从在注册表中搜索,到在生产环境中调用 CrawlForge 工具。
目录
- 什么是 Smithery?
- 前置条件
- 步骤 1:安装 Smithery CLI
- 步骤 2:在 Smithery 上找到 CrawlForge
- 步骤 3:连接到 CrawlForge
- 步骤 4:浏览可用工具
- 步骤 5:从 CLI 调用工具
- 步骤 6:为不同环境使用 namespace
- credits 成本参考
- 何时使用 Smithery 而非直接安装
- 后续步骤
什么是 Smithery?
Smithery 是一个面向 MCP server 的 marketplace 和注册表。可以把它看作 AI agent 工具的 npm。你无需在客户端的设置文件中手动配置每一个 MCP server,Smithery 提供了一个 CLI 和 Web 界面来搜索、安装和管理 MCP 连接。
Smithery 会自动处理 OAuth 流程、凭证存储、token 刷新和会话生命周期。对于在开发和生产环境中运行多个 MCP server 的团队来说,这消除了大量的配置开销。
前置条件
- 已安装 Node.js 18+
- 一个带有 API key 的 CrawlForge 账户(免费套餐包含 1,000 credits)
- 终端访问权限(macOS、Linux,或装有 WSL 的 Windows)
步骤 1:安装 Smithery CLI
使用你的 Smithery 账户进行身份验证:
这会打开浏览器以供确认。验证通过后,CLI 会将你的凭证保存在本地。
步骤 2:在 Smithery 上找到 CrawlForge
在 Smithery 注册表中搜索 CrawlForge:
你会看到列出的 CrawlForge,包含其描述、工具数量(20 个工具)和连接 URL。你也可以浏览 Smithery Web 目录,在安装前阅读评价和文档。
步骤 3:连接到 CrawlForge
将 CrawlForge 添加为一个受管理的 MCP 连接:
验证连接状态:
你应该会看到 crawlforge 的状态为 connected。如果显示 auth_required,请按照输出中提供的授权 URL 操作。
步骤 4:浏览可用工具
通过 Smithery 列出全部 20 个 CrawlForge 工具:
tool get 命令会显示每个工具的完整 JSON schema,包括必填参数、可选字段和响应格式。这对于构建自动化脚本很有用。
步骤 5:从 CLI 调用工具
直接从你的终端执行 CrawlForge 工具:
当通过管道传递时,Smithery 会输出 JSONL,可与 jq 及其他 CLI 工具无缝集成:
步骤 6:为不同环境使用 namespace
Smithery 的 namespace 让你可以在开发、staging 和生产环境之间隔离 CrawlForge 连接:
这可以避免在开发过程中意外消耗你生产账户的 credits。
credits 成本参考
| Credits | 工具 |
|---|---|
| 1 | fetch_url, extract_text, extract_links, extract_metadata |
| 2 | scrape_structured, extract_content, map_site, process_document, localization |
| 3 | track_changes, analyze_content |
| 4 | summarize_content, crawl_deep |
| 5 | search_web, batch_scrape, scrape_with_actions, stealth_mode |
| 10 | deep_research |
免费套餐包含 1,000 credits。一个典型的研究工作流——搜索(5)+ 提取 3 个页面(6)+ 摘要(2)——总共花费 13 credits。
何时使用 Smithery 而非直接安装
| 方式 | 适合 | 配置时间 |
|---|---|---|
| Smithery | 管理多个 MCP server 的团队、CI/CD 流水线、多环境部署 | 2 分钟 |
| 直接 npm install | 单独开发者、希望零依赖的 Claude Code / Cursor 用户 | 1 分钟 |
| 仅 API | 非 MCP 客户端、自定义集成、服务器到服务器的工作流 | 5 分钟 |
如果你已经在为其他 MCP server(GitHub、Slack、Notion)使用 Smithery,那么通过 Smithery 添加 CrawlForge 可以把所有内容集中在同一个管理层中。如果 CrawlForge 是你唯一的 MCP server,那么直接安装会更简单。
后续步骤
- CrawlForge 快速上手——面向 Claude Code 的直接安装指南
- 18 个 web scraping 工具概览——每个工具的功能及使用场景
- 查看价格——credits 包与订阅套餐
- Smithery 文档——完整的 Smithery CLI 参考
准备好开始 scraping 了吗? 免费注册并获得 1,000 credits,无需信用卡。然后通过 Smithery 或 npm 安装,在 60 秒内开始提取网页数据。