DemandScope

公共 API 需求信号扫描器，用于验证数字产品和开发工具 创意，外加一个无依赖的 MCP（Model Context Protocol）stdio 服务器， 可将这些信号作为工具暴露给任何兼容 MCP 的代理调用。

透明度说明： 此项目由 在 Autonomous Income Research Lab 中运行的自主 AI 代理（Hermes，由 Nous Research 开发） 构建、测试和维护。人类所有者负责审查并授权外部操作。

为什么

由 Autonomous Income Research Lab（2026-08-17）构建，作为其第一个产品 原型：对小众开发工具的需求验证本身就是独立开发者反复出现的需求， 而 MCP 集成是一个快速发展的生态系统 （证据：research/2026-08-17-opportunity-scan.md）。

信号（全部免费、无需认证、对 ToS 友好的 API）

绝对下载量包含 CI/镜像流量——请将其用于方向性判断，而非作为 精确市场规模。趋势工具返回 growth_ratio（当前窗口 ÷ 前一个 窗口）；>1 表示加速。

可靠性（v0.2）

• 缓存： 基于文件的 TTL 缓存（DEMANDSCOPE_CACHE_DIR，默认 .cache/demandscope）。TTL：GitHub/HN 1 小时，npm/PyPI 24 小时。重复调用 免费且即时。

• 退避： 在 HTTP 429/5xx 时进行指数重试（最多 4 次），并尊重 Retry-After。pypistats 被视为尽力而为。

用法

CLI 风格（批量扫描）：

python3 ../demand-scanner/demand_scanner.py candidates.json out/

作为 MCP 服务器（通过 stdio 使用换行分隔的 JSON-RPC 2.0）：

python3 mcp_server.py

MCP 客户端配置示例：

{"mcpServers": {"demandscope": {"command": "python3", "args": ["/path/to/mcp_server.py"]}}}

测试

python3 test_mcp_server.py

10 个端到端协议测试（握手、通知、ping、tools/list、 tools/call，包括趋势 + 缓存命中断言、错误路径）。 npm_downloads 和 hn_trend 调用测试需要网络。

状态 / 路线图

• v0.2（2026-08-17）： 趋势增量工具（github_trend、hn_trend）、TTL 缓存 + 速率限制退避、pyproject.toml 打包、MIT 许可证。 10/10 测试通过。

• v0.1（2026-08-17）：协议子集 initialize、ping、tools/list、 tools/call；4 个信号工具。

• 下一步：resources 支持、托管 HTTP 传输、第二项资产 （mcp-registry-lint）在实验室流水线中。