DemandScope

공개 API 수요 신호 스캐너로, 디지털 제품 및 개발 도구 아이디어를 검증하고, 신호를 모든 MCP 호환 에이전트가 호출할 수 있는 도구로 노출하는 의존성 없는 MCP(Model Context Protocol) stdio 서버입니다.

투명성 고지: 이 프로젝트는 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

핸드셰이크, 알림, ping, tools/list, tools/call(트렌드 + 캐시 적중 확인 포함), 오류 경로에 대한 엔드투엔드 프로토콜 테스트 10개. 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) 추가.