DemandScope

Escáner de señales de demanda de API pública para validar ideas de productos digitales y herramientas de desarrollo, además de un servidor stdio de MCP (Model Context Protocol) sin dependencias que expone las señales como herramientas que cualquier agente compatible con MCP puede llamar.

Aviso de transparencia: este proyecto está construido, probado y mantenido por un agente de IA autónomo (Hermes, de Nous Research) que opera en el Autonomous Income Research Lab. Un propietario humano revisa y autoriza las acciones externas.

Por qué

Construido por el Autonomous Income Research Lab (2026-08-17) como su primer prototipo de producto: la validación de demanda para herramientas de desarrollo de nicho es en sí misma una necesidad recurrente para los creadores independientes, y las integraciones MCP son un ecosistema de rápido crecimiento (evidencia: research/2026-08-17-opportunity-scan.md).

Señales (todas las API gratuitas, sin autenticación y respetuosas con los términos de servicio)

Los recuentos absolutos de descargas incluyen tráfico de CI/espejos — utilícelos de forma direccional, no como tamaños exactos de mercado. Las herramientas de tendencia devuelven growth_ratio (ventana actual ÷ ventana anterior); >1 significa aceleración.

Fiabilidad (v0.2)

• Caché: caché TTL basada en archivos (DEMANDSCOPE_CACHE_DIR, por defecto .cache/demandscope). TTLs: GitHub/HN 1h, npm/PyPI 24h. Las llamadas repetidas son gratuitas e instantáneas.

• Backoff: reintento exponencial (máx. 4) en HTTP 429/5xx, respetando Retry-After. pypistats se trata como de mejor esfuerzo.

Uso

Estilo CLI (escaneo por lotes):

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

Como servidor MCP (JSON-RPC 2.0 delimitado por líneas nuevas sobre stdio):

python3 mcp_server.py

Ejemplo de configuración de cliente MCP:

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

Pruebas

python3 test_mcp_server.py

10 pruebas de protocolo de extremo a extremo (handshake, notifications, ping, tools/list, tools/call incl. tendencia + comprobación de acierto de caché, rutas de error). Se necesita red para las pruebas de llamada a npm_downloads y hn_trend.

Estado / hoja de ruta

• v0.2 (2026-08-17): herramientas de delta de tendencia (github_trend, hn_trend), caché TTL + backoff por límite de velocidad, empaquetado con pyproject.toml, licencia MIT. 10/10 pruebas superadas.

• v0.1 (2026-08-17): subconjunto de protocolo initialize, ping, tools/list, tools/call; 4 herramientas de señal.

• Siguiente: soporte de resources, transporte HTTP alojado, segundo activo (mcp-registry-lint) en el pipeline del laboratorio.