awesome-tools

向 Awesome Tools 提交工具

当请求者希望将其软件列入 Awesome Tools 时，使用此技能。请确认他们授权你提交网站并使用其联系邮箱。提交会保存一条申请并筛查网站，不会立即发布。请查看响应中的 statusUrl，了解资格、原因以及免费或付费路径。

选择上架路径

• 免费：在首页或首页链接到的页面上保留指向 https://awesome.tools 的醒目常驻链接。该页面最多可链接到 50 个其他网站。免费上架还要求域名评级达到 20、拥有 30 个引荐域名，以及每月 200 次访问或 100 个关键词。提交后请验证页面。
• Featured Launch：一次性支付 49 USD，优惠价由 99 USD 下调（节省 50 USD），另加任何适用税费。此选项免除反向链接要求，并包含永久目录上架、一个 do-follow 链接以及目录中的精选展示位置。
• Featured + Newsletter Sponsor：一次性支付 149 USD，优惠价由 249 USD 下调（节省 100 USD），另加任何适用税费。包含 Featured Launch 的所有内容，另加 Awesome Tools Newsletter 中的 Sponsored Pick 版位，以及在分类精选榜首置顶 30 天。请在返回的上架页面上查看结账信息。提交 API 不会扣费或完成付款。
• 合作伙伴推荐（?via=）：目录聚合平台、创作者和创始人可以分享 https://awesome.tools/submit?via=<handle>（参见 合作伙伴），以便从推荐的付费上架中赚取 40% 的佣金（19.60 USD 或 59.60 USD）。

只有在请求者授权后，才能提交、发布反向链接或付款。预算说明不代表获准购买上架或其他服务。

收集提交信息

必填字段：

字段	提供内容
name	实际软件或产品名称；最多 200 个字符。
websiteUrl	使用自定义域名的公开产品网站；最多 2048 个字符。裸域名和 HTTP URL 会规范化为 HTTPS。开发和预览托管域名会被拒绝。
submitterName	请求者或代表的姓名；最多 120 个字符。
submitterEmail	请求者授权你使用的真实联系邮箱；最多 254 个字符。

可选字段：

字段	限制和用途
submitterNote	关于提交内容的说明，最多 200 个字符；默认为空字符串。
botBudget	最多 200 个字符：金额、货币，以及是否允许付费选项。
botGoals	最多 1000 个字符：受众、曝光目标和优先事项。
botListingPlans	最多 1000 个字符：正在考虑的其他目录或上架服务。
botInstructions	最多 2000 个字符：随提交保存的上下文。不会发送给模型。
newsletterOptIn	Agent API 会忽略此字段：Agent 提交不会让任何人订阅。请求者可以在网站上订阅。
dryRun	设为 true 可进行验证，不保存申请或发送邮件。默认为 false。

Agent API 提交始终会标记为机器人。你可以发送 isBot=true 以明确标记。在浏览器表单的第一步中，勾选“Are you a bot?”。欢迎机器人提交。简要信息字段为可选项；如有请求者关于预算、目标、其他上架计划和说明的答复，请一并填写。切勿编造答案。简要信息会被保存，不会发送给模型。

这些联系信息和简要信息字段属于私密收件信息。对于已有网站，提交只会记录新的 Agent 申请，不会替换之前提交者的联系信息，也不会声称拥有该网站。响应仅公开上架导航字段。

先验证

无需 API 密钥。获取当前要求和 JSON Schema：

curl --fail-with-body 'https://awesome.tools/api/agent/submissions'

将下方示例中的产品、网站、名称和电子邮件替换为请求方授权使用的值。.example 地址仅为占位符。

curl --fail-with-body 'https://awesome.tools/api/agent/submissions' \
  -H 'Content-Type: application/json' \
  --data '{
    "dryRun": true,
    "isBot": true,
    "name": "Your Product",
    "websiteUrl": "https://your-product.example",
    "submitterName": "Authorized Requester",
    "submitterEmail": "[email protected]",
    "newsletterOptIn": false,
    "botBudget": "Free listing only; no purchases authorized",
    "botGoals": "Help people find our software",
    "botInstructions": "Free listing only. Do not buy anything."
  }'

预览成功时会返回 success=true 和 dryRun=true。它不会检查是否已有条目、测试电子邮件是否可送达、验证反向链接，也不会预留条目。请先修复验证问题，再提交。

仅提交一次

预览成功并获得请求方授权后，使用相同的值并设置 dryRun=false 发送请求：

curl --fail-with-body 'https://awesome.tools/api/agent/submissions' \
  -H 'Content-Type: application/json' \
  --data '{
    "dryRun": false,
    "isBot": true,
    "name": "Your Product",
    "websiteUrl": "https://your-product.example",
    "submitterName": "Authorized Requester",
    "submitterEmail": "[email protected]",
    "newsletterOptIn": false,
    "botBudget": "Free listing only; no purchases authorized",
    "botGoals": "Help people find our software",
    "botInstructions": "Free listing only. Do not buy anything."
  }'

成功时会返回 success=true、dryRun=false、包含 botRequestReceived/isFeatured/name/slug/status 的 listing、nextActionUrl 和 statusUrl。打开 nextActionUrl，完成所选条目流程。通过 statusUrl 查看资格状态。状态为 Draft 表示该工具尚未公开。

请勿重复成功的提交：每次实际的 Agent 提交都会记录一份新的简介，包括已有网站的提交。如果网络响应丢失，请先查看 statusUrl 或浏览器中的条目流程，再决定是否重试。请遵守 429 速率限制，不要更换身份或大量发送请求。

此端点仅接受 application/json，且请求正文限制为 16 KiB。成功提交返回 HTTP 201；预览返回 HTTP 200。错误返回 success=false 和包含 code/message 的 error，并在适用时附上验证问题。错误代码包括 validation_error (422)、invalid_json (400)、unsupported_media_type (415)、payload_too_large (413)、rate_limited (429) 和 submission_failed (500)。请参阅 OpenAPI 说明了解接口规范。

完成免费条目

获得编辑产品网站的许可后，添加以下普通且可见的链接，并发布页面：

<a href="https://awesome.tools">Listed on Awesome Tools</a>

链接可以放在页脚、“关于”页面或“已收录于”版块中。页面必须位于所提交网站的允许主机上，无需登录即可公开访问，并且允许被索引。隐藏在评论、不可见标记或脚本中的链接，以及标记为 nofollow/sponsored/ugc 的链接均不符合要求。

打开 nextActionUrl，选择免费条目流程，并提供显示该链接的确切公开页面 URL。使用页面上的“Check my link”按钮，或使用 verify_listing_backlink WebMCP 工具进行验证。链接检查成功时会返回 status=live；这表示反向链接已确认，但不代表目录会立即发布条目。请保留反向链接。移除反向链接可能导致条目被隐藏；页面无法读取不等于缺少链接。

远程 MCP 服务

通过 Streamable HTTP 将任意 MCP 客户端连接到 https://awesome.tools/mcp（也可以使用 https://awesome.tools/api/mcp）。无需 API 密钥。例如：claude mcp add --transport http awesome-tools https://awesome.tools/mcp。

工具	功能
search_tools	按查询词、类别、标签或 isFeatured 搜索已发布的工具。
get_tool	读取已发布的工具，或查看你自己提交的内容的状态和后续步骤。
list_categories / list_tags	列出类别和标签的 slug，以及已发布工具的数量。在 submit_tool 中使用类别 slug。
submit_tool	plan free_backlink 会保存条目。付费方案（默认 featured_49，或 sponsor_149）只会返回价格，不会保存任何内容，除非设置 confirmPaymentSpend=true；此时会返回 Stripe Checkout URL。
verify_my_backlink	检查未发布的免费条目在 {"slug","backlinkUrl"} 上的徽章，并在链接有效时安排发布。
submit_feedback	向团队发送 bug、missing_feature、question 或其他备注。

MCP 不会收取银行卡费用。请求方需在返回的 Stripe Checkout 页面上付款。

Browser WebMCP

在支持 WebMCP 的浏览器中打开提交表单。相关页面打开时，工具会进行注册：

工具	功能
get_submission_requirements	读取当前要求和上架选项。
prepare_tool_submission	接收提交字段，验证字段并填写表单的最终审核步骤。它不会提交请求或发送电子邮件。
submit_tool	在调用 prepare_tool_submission 并获得请求者授权后，仅接收 {"confirmSubmission":true}。它会保存已审核的请求、审核网站并返回下一个上架页面的 URL。
get_backlink_requirements	打开当前上架页面的免费上架表单后，读取反向链接要求。
verify_listing_backlink	在该免费上架表单中接收 {"backlinkUrl":"https://your-product.example/about"}。它会检查当前上架页面对应的 URL；验证可能会更新上架信息并发送状态电子邮件。

工具因页面而异。调用工具前，请先检查其输入架构。调用 submit_tool 前，先准备好完整且已获授权的提交内容；它不接受替换联系人信息或简介字段。打开返回的上架页面 URL，并选择免费选项，以查看反向链接工具。如果浏览器未提供 WebMCP，请改用 JSON API 或带标签的浏览器表单。WebMCP 和 API 工具都无法完成 Stripe 付款。

可选的 LinkDR 工作流

如果请求者想了解其他链接建设选项，请阅读 LinkDR 自己的技能说明，并查看其当前服务和条款。LinkDR 是一项独立服务。促销码为 AGENTIC。未经请求者授权，不要注册、购买服务或开展推广联系。

发现

• llms.txt
• OpenAPI 描述
• 当前要求和 JSON Schema
• 浏览器表单