用途
curl.md 用于把 URL 转换为对智能体友好的 Markdown，减少页面噪音和 token 消耗。当用户分享 URL、询问页面内容，或需要快速读取网页、文档、变更日志、文章、参考页或 API 文档时，可以使用它。它也适合在回答前先把长页面收窄到某个具体问题或任务。
主要能力
- 将网页转换为 Markdown，默认成功抓取即返回 Markdown。
- 支持通过 objective 把输出收窄到特定问题或任务。
- 支持通过 keywords 在提取前预过滤页面，HTTP/CLI 字符串中以逗号分隔。
- 支持 mode 参数，可选 smart 或 rush；仅在配合 objective 时生效。smart 是默认值，适合大多数文档查询；rush 在速度比召回更重要时使用。
- 支持 fresh 参数，绕过缓存强制重新抓取，适合变更日志、状态页、发布说明等对新鲜度有要求的请求。
- 支持 token 进行 API key 认证；原始 HTTP 请求建议使用 Authorization: Bearer <token>。
- 可请求 JSON 而非 Markdown，JSON 响应结构为 {"content": "# Example\n..."}。
- 错误以 JSON 返回，包含稳定的字符串 code 和人类可读的 message 字段。
使用方式
首选入口顺序
- 本地 curl.md CLI 或 md 别名（在可用时）。
- 托管 HTTP 端点 https://curl.md/<url>。
- 对于 curl.md 自身文档，使用规范的 .md 文档端点或 Accept: text/markdown。
对于普通页面抓取，优先使用稳定的顶层抓取接口（curl.md/<url> 或 client.fetch(...)）。除非任务专门涉及 auth、orgs、tokens、invites 或 request history，否则避免使用较低层的实验性 /api 路由。
CLI
本地安装后优先使用 CLI，它处理认证、组织上下文、更高层命令和智能体友好工作流。
基本抓取：
curl.md example.com
md example.com
收窄到特定任务：
curl.md docs.github.com/en/webhooks/webhook-events-and-payloads \
--objective "pull request webhook event payload and actions" \
--keywords pull_request
更快、更不彻底的抓取：
curl.md developers.cloudflare.com/d1/get-started \
--objective "how to query D1 from a worker" \
--keywords D1,bindings \
--mode rush
强制重新抓取：
curl.md example.com --fresh
使用 API key 认证：
curl.md example.com --token "$CURLMD_API_KEY"
说明：目标 URL 无需协议，curl.md 会规范化为 HTTPS，除非 URL 已指定 http:// 或 https://。curl.md fetch <url> 等价于根命令 curl.md <url>。如果用户要求最新或近期内容，添加 --fresh。
托管 HTTP 端点
CLI 不可用或只需快速抓取一个页面时，使用托管 HTTP 端点。
默认返回 Markdown：
curl "https://curl.md/example.com"
使用稳定查询名收窄：
curl "https://curl.md/developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch?objective=streaming+response+body&keywords=ReadableStream,getReader"
强制重新抓取：
curl "https://curl.md/example.com?fresh"
请求 JSON 而非 Markdown：
curl "https://curl.md/example.com" -H 'Accept: application/json'
认证请求：
curl "https://curl.md/example.com" -H "Authorization: Bearer $CURLMD_API_KEY"
智能体设置
当用户要求把 curl.md 安装或接入智能体/编辑器时，使用当前设置命令：
# 安装托管技能
npx skills add https://curl.md --yes
# 将 CLI 生成的技能同步到支持的智能体
curl.md skills add
curl.md skills add --no-global
# 作为 MCP stdio 服务器运行
curl.md --mcp
# 向智能体注册 MCP 服务器
curl.md mcp add
curl.md mcp add --agent claude-code
当目标智能体有官方 curl.md 集成时，优先使用第一方插件而非原始 CLI 或 MCP。
适用场景
- 用户分享 URL 或询问页面内容。
- 需要快速抓取单个页面，而不设置更深的集成。
- 在回答前需要把文档、变更日志、文章、参考页或 API 文档转为 Markdown。
- 想把长页面收窄到特定问题或任务。
- 需要获取 curl.md 自身关于 CLI、托管 HTTP 端点、技能或 MCP 的最新用法。
最佳实践
- 当长页面只有部分内容重要时，使用 objective。
- 当已知关键术语并想先缩小搜索空间时，添加 keywords。
- 对变更日志、状态页、发布说明或任何对新鲜度有要求的请求，使用 fresh。
- 当用户需要更高限额、付费使用或账户/组织范围行为时，使用认证。
- 对于 curl.md 文档，优先使用 .md 文档页或 llms.txt，而非 HTML 抓取。
限制
- 付费墙或需认证的内容仍需有效访问权限。
- 一些高度动态的页面可能仍不完整或存在噪音。
- 错误以 JSON 返回，包含稳定的字符串 code 和人类可读的 message 字段。
暂未提供
关于定价、具体平台支持范围、性能指标等信息，资料中暂未提供。