DemandScope

DemandScope

デジタルプロダクトや開発者向けツールのアイデアを検証するための、公開 API を利用した需要シグナルスキャナーです。また、シグナルをツールとして公開し、MCP 対応のあらゆるエージェントから呼び出せる、依存関係のない MCP（Model Context Protocol）stdio サーバーでもあります。

透明性に関するお知らせ： このプロジェクトは、自律収益リサーチラボで稼働する自律型 AI エージェント（Nous Research の Hermes）によって開発、テスト、保守されています。外部アクションは人間のオーナーが確認し、承認します。

理由

Autonomous Income Research Lab が最初の製品プロトタイプとして構築しました（2026-08-17）。ニッチな開発者向けツールの需要検証は、個人開発者にとってそれ自体が繰り返し必要となるものであり、MCP 連携のエコシステムも急速に成長しています（根拠：research/2026-08-17-opportunity-scan.md）。

シグナル（すべて無料、認証不要、利用規約に配慮した API）

ツール	ソース	代理指標
github_repo_signal	api.github.com/search	開発者の関心／競合状況
github_trend	api.github.com (created:)	供給／関心の加速（差分）
hn_signal	hn.algolia.com (Hacker News)	技術系オーディエンスの注目度
hn_trend	hn.algolia.com	注目度の加速（差分）
npm_downloads	api.npmjs.org	類似製品の需要
pypi_downloads	pypistats.org	類似製品の需要

ダウンロード数の絶対値には、CI やミラー経由のトラフィックが含まれます。正確な市場規模としてではなく、傾向を把握するために利用してください。トレンドツールは growth_ratio（現在の期間 ÷ 直前の期間）を返します。1 を超える場合は加速しています。

信頼性（v0.2）

• キャッシュ： ファイルベースの TTL キャッシュ（DEMANDSCOPE_CACHE_DIR、デフォルトは .cache/demandscope）。TTL：GitHub/HN は 1 時間、npm/PyPI は 24 時間です。繰り返しの呼び出しは無料で、即座に応答します。
• バックオフ： HTTP 429/5xx に対して、Retry-After に従いながら指数バックオフで再試行します（最大 4 回）。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"]}}}

MCP Registry / MCPB バンドル

DemandScope は、公式 MCP Registry に io.github.baobabcat/demandscope として公開されています。各リリースには、scripts/build_mcpb.py でビルドされる、再現性のあるワンクリックインストール可能な MCP Bundle（demandscope.mcpb、仕様 0.3）が添付されます。公開は GitHub OIDC を使用して CI から実行されます（.github/workflows/publish-mcp.yml、保存済みシークレットは不要です）。レジストリマニフェスト（server.json）は、公開のたびにmcp-registry-lintとmcp-publisher validateで検証されます。

テスト

python3 test_mcp_server.py

エンドツーエンドのプロトコルテストを 10 件実施します（ハンドシェイク、通知、ping、tools/list、tools/call。トレンドとキャッシュヒットのアサーションを含むほか、エラー経路もテストします）。npm_downloads と hn_trend の呼び出しテストにはネットワーク接続が必要です。

ステータス／ロードマップ

• v0.3 (2026-08-20)： MCPB バンドルと、GitHub OIDC を利用した公式 MCP Registry への公開（server.json、再現性のある scripts/build_mcpb.py、タグトリガーによる公開ワークフローとロールバック）。テストは 10/10 件合格。
• 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 トランスポート、ラボのパイプラインへの 2 つ目のアセット（mcp-registry-lint）の追加。