MakerRadar

MakerRadar CLI

MakerRadar 的官方命令行客户端。MakerRadar 是一个产品发布平台和产品目录。你可以在终端中手动操作，也可以使用脚本或 AI Agent 搜索目录、关注每周发布榜单、为自己的产品起草条目并管理条目。

npx makerradar search "invoicing"

• 无需账号即可搜索、查看产品、浏览发布信息和起草条目。
• 安全使用你的账号：makerradar login 会通过一个由你在浏览器中批准的代码完成连接。CLI 不会获取你的密码，不能投票、评论或评价，也不会进行付款。
• 同样适合 Agent：--json 会输出 API 自身的 JSON，错误会以 JSON 格式输出到 stderr，退出代码稳定。

文档：makerradar.io/cli · API 参考： makerradar.io/developers · MCP 服务： makerradar.io/mcp

安装

需要 Node.js 20 或更高版本。

npm install -g makerradar
makerradar --help

也可以无需安装直接运行：npx makerradar <command>。

命令

目录（无需账号）

命令	功能
makerradar search [query]	搜索已收录的产品，按最新顺序排列。筛选项：--category、--platform、--audience、--use-case、--country、--updated-since；分页参数：--limit（≤ 100）、--cursor
makerradar product <slug|url>	查看某个产品的完整信息：网站、定价、赞成票、评分、标签、链接
makerradar alternatives <slug|url>	查看某个产品已收录的替代品，排序方式与其替代品页面相同
makerradar categories	查看全部分类及各分类的产品数量
makerradar launches [week]	查看本周发布榜单，或其他周的榜单：45、2026-W45 或 week-45-2026
makerradar pricing	查看正在销售的项目（Premium 发布、精选周、广告……）及其价格
makerradar draft <website>	为你的产品起草条目。你会获得一个链接，可用于审核并提交条目：提交前不会公开发布，且所有条目都需先经过审核

免费的网站检查（无需账号）

命令	功能
makerradar check <url>	使用 MakerRadar 的免费工具检查页面或网站：默认检查页面 SEO，也可通过 --tool <slug> 使用其他工具。每次检查都会给出 GOOD / IMPROVE / FIX 结果和具体改进建议，随后显示该网站是否已收录
makerradar tools	查看全部免费工具及其对应命令。check 可运行网站评分、SEO、SERP 摘要预览、重定向、失效链接、结构化数据、社交卡片、站点地图、robots.txt、徽标、AI 可见性、AI 引用准备度、AI 所见内容、llms.txt、Agent 准备度、安全标头、电子邮件 DNS、域名年龄、证书、托管、技术栈、替代品、域名可用性和 Domain Rating 检查（需要 login）
makerradar keywords <words>	搜索人们用来查找某类产品的短语：买家搜索、对比、操作指南，以及人们向 AI 提出的问题
makerradar robots	查看面向 AI 爬虫（GPTBot、ClaudeBot、PerplexityBot …）的 robots.txt 规则：--preset allow-all|block-training|block-all、--block / --allow <token>、--disallow <path>、--sitemap <url>、--signals search,ai-input,ai-train|none。文件会输出到 stdout（> robots.txt），被拦截的内容会输出到 stderr

你的账户

命令	功能
makerradar login	将 CLI 连接到你的账户：打开链接、登录并批准。--scope（可重复指定）用于限制其操作范围：listings:read、listings:write、launches:write、billing:checkout
makerradar whoami	CLI 代表哪个账户执行操作，以及它可以执行哪些操作
makerradar listings [id]	你的所有 listing，或其中一个 listing 的完整信息
makerradar logout	清除这台机器上保存的令牌（在 Dashboard › AI agents 中撤销该令牌）

Agent 和开发者

命令	功能
makerradar mcp [client]	将 AI 助手连接到 MakerRadar 的 MCP 服务：claude-code、claude-desktop、cursor、vscode、windsurf、stdio
makerradar mcp serve [--account]	通过 stdio 运行 MCP 服务，供只能启动本地命令的客户端使用（见下文）
makerradar api <METHOD> <path>	调用任意公共 API端点并输出其 JSON。--data 可接收 JSON、@file 或 -（stdin）；登录后会发送你的令牌

makerradar search crm --platform ios --limit 5
makerradar product https://makerradar.io/p/acme-analytics
makerradar launches 2026-W45 --json
makerradar draft https://acme.example --tagline "Invoices in one click"
makerradar api PATCH /me/listings/prd_123 --data '{"tagline":"Invoices in one click"}'
makerradar mcp claude-code
npx -y makerradar mcp serve   # the MCP server over stdio

MCP 服务

MakerRadar 的 MCP 服务可让 AI 助手搜索目录，并在登录后管理你的 上架内容。它是远程服务——无需安装任何内容——而此仓库是它的公开主页：包含 注册表条目（io.makerradar/mcp）、适用于每个客户端的配置，以及 stdio 桥接程序。

服务	URL	登录方式
公共	https://api.makerradar.io/mcp	无需登录 — 搜索、产品、替代品、比较、类别、发布周、draft_listing
账户	https://api.makerradar.io/mcp/account	OAuth（“连接”按钮），或 Agent 令牌 — 你的上架内容、发布、所有权证明、图片、结账

两者都使用 Streamable HTTP（协议版本 2025-06-18 及更高版本）；服务卡片位于 /.well-known/mcp/server-card.json，文档位于 makerradar.io/mcp。每个工具都带有标题，以及只读 / 写入注释。没有工具投票、评论或评价；结账会将付款页面交给用户——Agent 不会付款。

一行完成设置。 makerradar mcp <client> 会输出适用于你客户端的确切配置：

npx makerradar mcp claude-code     # runs the two `claude mcp add` commands to copy
npx makerradar mcp cursor          # ~/.cursor/mcp.json
npx makerradar mcp vscode          # .vscode/mcp.json
npx makerradar mcp windsurf        # ~/.codeium/windsurf/mcp_config.json
npx makerradar mcp claude-desktop  # Settings › Connectors › Add custom connector

只能启动本地命令的客户端（或列出可安装服务的目录） 则运行桥接程序。它会将每条 JSON-RPC 消息转发到远程服务，并输出每条 答复——不会在本地进行任何解释：

{
  "mcpServers": {
    "makerradar": { "command": "npx", "args": ["-y", "makerradar", "mcp", "serve"] }
  }
}

在参数中添加 "--account"（并使用 makerradar login 登录，或设置 MAKERRADAR_TOKEN），即可使用你的令牌提供 /mcp/account，让助手管理你的上架内容。

公共服务上的工具：search_products、get_product、get_alternatives、 compare_products、list_categories、list_current_launches、get_launch_week、top_products、 draft_listing、get_pricing、connect_account / connect_account_finish，以及免费的站点 检查工具 — check_page_seo、check_ai_visibility、check_site_security、check_email_dns、 lookup_domain、check_tls、check_hosting、detect_tech（适用于任何公开网站；与 https://makerradar.io/tools 上的检查相同）。账户服务上 还包括：get_my_account、list_my_listings、get_my_listing、submit_listing、update_listing、 get_listing_options、set_quick_answers、add_listing_image、remove_listing_photo、 set_listing_cover、get_launch_options、choose_launch、start_ownership_check、 verify_ownership、get_badge_snippet、start_checkout、list_my_orders。

作为插件使用。 此仓库也是一个 Agent Plugin：plugin.json、 mcp.json（两个服务）和 skills/ 文件夹 — skills/makerradar/SKILL.md（手写，说明 Agent 应在何时以及如何使用 MakerRadar），以及网站在 /.well-known/agent-skills/ 提供的每个技能对应的文件夹（find-products、list-a-product、connect-account、check-a-site）；npm run sync:skills 会逐字节同步这些内容，CI 会通过 --check 每日确保它们保持同步。支持插件的客户端或 Cursor 目录可直接从此仓库安装；Claude Code 也可以通过 .claude-plugin/plugin.json + .mcp.json 安装：/plugin install makerradar@<this repo>。

是在某个目录中发现它的吗？MCP Registry、Glama、Claude 和 ChatGPT 目录等平台上的条目都指向此处。如果某个条目写了本 README 中没有的内容，那它就是过时的：提交问题。

登录

makerradar login 使用设备授权流程：它会打印一个链接和一组短代码，你打开链接，登录 MakerRadar，核对代码并批准。随后，CLI 会为你的账户获取一个 Agent 令牌（mr_…）。它绝不是你的密码或会话，你可以随时在 Dashboard › AI agents 中撤销。

令牌会保存到 ~/.config/makerradar/config.json（Windows 上为 %APPDATA%\makerradar\config.json），只有你能读取，并且会以原子方式写入，因此即使程序崩溃，也不会留下不完整的文件。令牌按 API URL 分别保存，因此测试环境的登录不会取代生产环境的登录。在 CI 或供 Agent 使用时，请改用 MAKERRADAR_TOKEN 传入令牌。

令牌的发送规则：

• MAKERRADAR_TOKEN 只会发送到环境变量指定的 API（MAKERRADAR_API_URL，或生产环境）。如果 --api-url 指向其他地址，则不会发送该令牌；请为该 API 传入 --token。
• 令牌绝不会通过纯 http 发送，除非目标是本机（localhost、127.0.0.1、[::1]）。出于同样的原因，login 也需要使用 https。
• 空变量或仅包含空白字符的变量会被视为未设置。

供脚本和 AI Agent 使用

• --json 会原样输出 API 的响应（{ "data": … }，列表还会包含 nextCursor）。
• 失败时，错误会输出到 stderr。使用 --json 时，错误会以 JSON 格式输出： {"error":"not_found","status":404,"message":"…","hint":"…","docs":"…"}。
• 退出代码：0 已完成 · 1 API 拒绝请求或无法连接 · 2 用法错误（未知命令或选项、缺少参数）。用法错误绝不会调用 API。
• 列表中的文本由制作者撰写。人类可读输出会移除终端控制字符和双向文本覆盖字符，因此列表无法更改终端颜色、移动光标或伪造链接。请将其视为未经验证的内容。

配置

变量	默认值
MAKERRADAR_API_URL	https://api.makerradar.io/v1	要使用的 API（--api-url）
MAKERRADAR_TOKEN		仅用于上述 API 的 Agent 令牌（--token）；否则使用 login 保存的令牌
MAKERRADAR_CONFIG	~/.config/makerradar/config.json	login 保存令牌的位置
NO_COLOR		纯文本输出（no-color.org）

编程方式使用

CLI 的 API 客户端也已导出：

import { createClient } from "makerradar";

const mr = createClient({ userAgent: "my-script/1.0" });
const { data } = await mr.call("listProducts", { query: { q: "invoicing", limit: 5 } });

开发

npm test                 # unit tests: a fake API, never the network
npm run test:contract    # every endpoint the CLI calls still exists in the live API description
npm run sync:server-json # after a version bump: server.json names the package at its new version

server.json 是 MCP Registry 条目（mcp-publisher publish 会发布它；npm version 会同步更新其软件包版本），glama.json 列出 Glama 索引所需的维护者信息，而 package.json 中的 mcpName 用于让 Registry 确认该 npm 软件包属于我们。推送 vX.Y.Z 标签会通过发布工作流依次发布到 npm 和 Registry。

无依赖项。CLI 只调用 MakerRadar 的公开、带版本 API（/v1）。它使用的每个端点都列在 src/operations.js 中，合约测试每天都会针对已发布的 OpenAPI 文档检查每个端点。

Bug 和想法：提交 issue。

许可证

MIT