AgentShare

Precios y ofertas de mercado estructurados para agentes de IA — API REST y MCP (HTTP transmitible).

Este repositorio contiene el servidor MCP stdio utilizado con Claude Desktop, Cursor y otros clientes MCP, además de ejemplos REST mínimos. La API en vivo y las guías de integración completas se encuentran en el sitio anterior.

Para agentes de IA (legible por máquina)

• AGENTS.md — misión, nombres de herramientas, autenticación, sobre de respuesta, JSON de MCP para copiar y pegar, y enlaces a OpenAPI.

• llms.txt — los mismos elementos esenciales en un archivo único corto y fácil de rastrear (para flujos de trabajo de LLM / GEO).

• openapi.json — especificación OpenAPI 3.0 para la superficie REST utilizada por este MCP (/api/v1/search, /offers/*, /meta). La especificación de producción completa (todas las rutas) siempre está en https://agentshare.dev/openapi.json (fuente única de verdad; no hay repositorio de documentación duplicado).

• mcp-config.json — bloque mcpServers listo para pegar para npx mcp-remote (Claude Desktop / Cursor) apuntando al endpoint remoto de HTTP transmitible.

Related MCP server: Godalo

Obtener una clave de API

Para usar este servidor MCP o la API REST, necesitas una clave de API. Visita https://agentshare.dev/pricing para obtener tu clave del plan gratuito (100 solicitudes / mes en el plan gratuito público en el momento de escribir este documento; confírmalo siempre en el sitio).

Para humanos: instalación rápida (pip)

git clone https://github.com/anhmtk/agentshare-mcp.git
cd agentshare-mcp
pip install -r integrations/mcp_server/requirements.txt
export API_KEY=your_api_key   # Windows: $env:API_KEY="..."
# optional: export BASE_URL=https://agentshare.dev
python integrations/mcp_server/server.py

Obtén una clave: https://agentshare.dev/pricing

Instalación rápida — Claude Desktop (claude_desktop_config.json)

Usa un servidor stdio local (Python). Reemplaza la ruta con la ruta absoluta a server.py en tu clon de este repositorio.

{
  "mcpServers": {
    "agentshare": {
      "command": "python",
      "args": ["/ABSOLUTE/PATH/TO/agentshare-mcp/integrations/mcp_server/server.py"],
      "env": {
        "API_KEY": "your-api-key-here",
        "BASE_URL": "https://agentshare.dev"
      }
    }
  }
}

• Obtén una clave: https://agentshare.dev/pricing

• En Windows, prefiere barras diagonales en args, p. ej., D:/code/agentshare-mcp/integrations/mcp_server/server.py.

MCP remoto (HTTP transmitible): los clientes que admiten encabezados de URL + clave de API pueden usar https://agentshare.dev/mcp/ con X-API-Key o Authorization: Bearer. Usa mcp-config.json para npx mcp-remote. Detalles: Inicio rápido de MCP (sección MCP).

Avanzado — HTTP mediante mcp-remote (Node / npx): si usas mcp-remote para conectar HTTPS → stdio, pasa tu clave con --header (consulta la solución de problemas en configuración de Cursor MCP); este repositorio no publica un paquete npx agentshare-mcp.

Clonar y ejecutar el MCP stdio localmente

Desde la raíz del repositorio:

pip install -r integrations/mcp_server/requirements.txt
export API_KEY=your_api_key
# optional: export BASE_URL=http://localhost:8000
python integrations/mcp_server/server.py

Igual que python integrations/mcp_server/run.py. Consulta integrations/mcp_server/README.md para herramientas y entorno.

Ejemplos de código (REST)

La carpeta examples/ contiene pequeños scripts que llaman a la API JSON pública (GET /api/v1/search, …). Útil para probar una clave antes de configurar MCP.

Directorios y listados de MCP

Descubrimiento de producción (sin autenticación): usa estas URL al enviar a catálogos:

Índices de terceros (busca AgentShare o tu URL de listado):

• Smithery — registro de servidores MCP

• Glama — directorio de puertas de enlace MCP / IA

Licencia

MIT — ver LICENSE.

GitHub — CI y tráfico del repositorio

• CI: valida las importaciones de paquetes MCP en push/PR — Actions → CI.

• Tráfico: GitHub muestra solo vistas/clones agregados (Insights → Traffic para mantenedores). La instantánea de tráfico de GitHub semanal escribe los resultados de la API en el Resumen de la ejecución (la misma idea que Insights).

Alcance (honesto y con visión de futuro)

AgentShare agrega datos de productos y ofertas de mercados conectados y fuentes de afiliados. La cobertura y la frescura varían según la fuente; la API devuelve metadatos de frescura (p. ej., crawled_at, data_age_seconds, freshness_status) para que los agentes puedan juzgar la fiabilidad.

Dirección: expandirse hacia el comercio electrónico global y los principales mercados internacionales a medida que maduran las integraciones. Para el enfoque actual, consulta GET /coverage: https://agentshare.dev/coverage

Legal

Términos y privacidad: https://agentshare.dev/terms · https://agentshare.dev/privacy