AgentShare

Strukturierte Marktplatzpreise und Angebote für KI-Agenten — REST-API und MCP (Streamable HTTP).

Dieses Repository enthält den stdio MCP-Server, der mit Claude Desktop, Cursor und anderen MCP-Clients verwendet wird, sowie minimale REST-Beispiele. Die Live-API und vollständige Integrationsanleitungen finden Sie auf der oben genannten Website.

Für KI-Agenten (maschinenlesbar)

• AGENTS.md — Mission, Tool-Namen, Authentifizierung, Antwort-Envelope, Copy-Paste MCP JSON und Links zu OpenAPI.

• llms.txt — dieselben Grundlagen in einer kurzen, crawl-freundlichen Einzeldatei (für LLM / GEO-Workflows).

• openapi.json — OpenAPI 3.0 Spezifikation für die REST-Oberfläche, die von diesem MCP verwendet wird (/api/v1/search, /offers/*, /meta). Die vollständige Produktionsspezifikation (alle Routen) befindet sich immer unter https://agentshare.dev/openapi.json (Single Source of Truth; kein separates Doku-Repo).

• mcp-config.json — ein fertiger mcpServers-Block für npx mcp-remote (Claude Desktop / Cursor), der auf den Remote-Streamable-HTTP-Endpunkt verweist.

Related MCP server: Godalo

API-Schlüssel erhalten

Um diesen MCP-Server oder die REST-API zu nutzen, benötigen Sie einen API-Schlüssel. Besuchen Sie https://agentshare.dev/pricing, um Ihren Schlüssel für den kostenlosen Tarif zu erhalten (100 Anfragen / Monat im öffentlichen kostenlosen Plan zum Zeitpunkt der Erstellung – bitte immer auf der Website bestätigen).

Für Menschen: Schnelle Installation (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

Schlüssel erhalten: https://agentshare.dev/pricing

Schnelle Installation — Claude Desktop (claude_desktop_config.json)

Verwenden Sie einen lokalen stdio-Server (Python). Ersetzen Sie den Pfad durch den absoluten Pfad zu server.py in Ihrem Klon dieses Repos.

{
  "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"
      }
    }
  }
}

• Schlüssel erhalten: https://agentshare.dev/pricing

• Unter Windows sollten Sie in args bevorzugt Schrägstriche verwenden, z. B. D:/code/agentshare-mcp/integrations/mcp_server/server.py.

Remote MCP (Streamable HTTP): Clients, die URL + API-Schlüssel-Header unterstützen, können https://agentshare.dev/mcp/ mit X-API-Key oder Authorization: Bearer verwenden. Nutzen Sie mcp-config.json für npx mcp-remote. Details: MCP Quickstart (Abschnitt MCP).

Fortgeschritten — HTTP via mcp-remote (Node / npx): Wenn Sie mcp-remote verwenden, um HTTPS → stdio zu überbrücken, übergeben Sie Ihren Schlüssel mit --header (siehe Fehlerbehebung in Cursor MCP-Einrichtung); dieses Repo veröffentlicht kein npx agentshare-mcp-Paket.

stdio MCP lokal klonen & ausführen

Vom Repository-Stammverzeichnis aus:

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

Identisch mit python integrations/mcp_server/run.py. Siehe integrations/mcp_server/README.md für Tools und Umgebung.

Code-Beispiele (REST)

Der Ordner examples/ enthält kleine Skripte, die die öffentliche JSON-API aufrufen (GET /api/v1/search, …). Nützlich zum Testen eines Schlüssels, bevor MCP eingerichtet wird.

MCP-Verzeichnisse & Auflistungen

Produktions-Discovery (keine Authentifizierung) — verwenden Sie diese URLs bei der Einreichung in Kataloge:

Indizes von Drittanbietern (suchen Sie nach AgentShare oder Ihrer Listing-URL):

• Smithery — MCP-Server-Verzeichnis

• Glama — MCP / AI-Gateway-Verzeichnis

Lizenz

MIT — siehe LICENSE.

GitHub — CI & Repo-Traffic

• CI: validiert MCP-Paketimporte bei Push/PR — Actions → CI.

• Traffic: GitHub zeigt nur aggregierte Aufrufe/Klone an (Insights → Traffic für Maintainer). Der wöchentliche GitHub-Traffic-Snapshot schreibt API-Ergebnisse in die Summary des Laufs (ähnliches Konzept wie Insights).

Umfang (ehrlich & zukunftsorientiert)

AgentShare aggregiert Produkt- und Angebotsdaten von verbundenen Marktplätzen und Affiliate-Quellen. Abdeckung und Aktualität variieren je nach Quelle; die API liefert Aktualitäts-Metadaten (z. B. crawled_at, data_age_seconds, freshness_status), damit Agenten die Zuverlässigkeit beurteilen können.

Richtung: Expansion in Richtung globaler E-Commerce und großer internationaler Marktplätze, sobald die Integrationen ausgereift sind. Für den aktuellen Fokus siehe GET /coverage: https://agentshare.dev/coverage

Rechtliches

AGB und Datenschutz: https://agentshare.dev/terms · https://agentshare.dev/privacy