AgentShare

Структурированные цены и предложения маркетплейсов для AI-агентов — REST API и MCP (Streamable HTTP).

Этот репозиторий содержит stdio MCP-сервер, используемый с Claude Desktop, Cursor и другими MCP-клиентами, а также минимальные примеры REST. Актуальный API и полные руководства по интеграции находятся на сайте выше.

Для AI-агентов (машиночитаемый формат)

• AGENTS.md — миссия, названия инструментов, аутентификация, конверт ответа, JSON для копирования в MCP и ссылки на OpenAPI.

• llms.txt — те же основные сведения в коротком, удобном для парсинга едином файле (для рабочих процессов LLM / GEO).

• openapi.json — спецификация OpenAPI 3.0 для REST-интерфейса, используемого этим MCP (/api/v1/search, /offers/*, /meta). Полная производственная спецификация (все маршруты) всегда доступна по адресу https://agentshare.dev/openapi.json (единственный источник истины; нет дублирующего репозитория с документацией).

• mcp-config.json — готовый к копированию блок mcpServers для npx mcp-remote (Claude Desktop / Cursor), указывающий на удаленный эндпоинт Streamable HTTP.

Related MCP server: Godalo

Получение API-ключа

Чтобы использовать этот MCP-сервер или REST API, вам нужен API-ключ. Посетите https://agentshare.dev/pricing, чтобы получить ключ бесплатного уровня (100 запросов в месяц на момент написания — всегда уточняйте информацию на сайте).

Для людей: быстрая установка (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

Получить ключ: https://agentshare.dev/pricing

Быстрая установка — Claude Desktop (claude_desktop_config.json)

Используйте локальный stdio сервер (Python). Замените путь на абсолютный путь к server.py в вашей копии этого репозитория.

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

• Получить ключ: https://agentshare.dev/pricing

• В Windows предпочтительнее использовать прямые слэши в args, например D:/code/agentshare-mcp/integrations/mcp_server/server.py.

Удаленный MCP (Streamable HTTP): клиенты, поддерживающие заголовки URL + API-ключ, могут использовать https://agentshare.dev/mcp/ с X-API-Key или Authorization: Bearer. Используйте mcp-config.json для npx mcp-remote. Подробности: MCP Quickstart (раздел MCP).

Продвинутый уровень — HTTP через mcp-remote (Node / npx): если вы используете mcp-remote для соединения HTTPS → stdio, передайте свой ключ с помощью --header (см. устранение неполадок в настройке Cursor MCP); этот репозиторий не публикует пакет npx agentshare-mcp.

Клонирование и запуск stdio MCP локально

Из корня репозитория:

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

То же самое, что python integrations/mcp_server/run.py. См. integrations/mcp_server/README.md для инструментов и окружения.

Примеры кода (REST)

В папке examples/ есть небольшие скрипты, которые вызывают публичный JSON API (GET /api/v1/search, …). Полезно для тестирования ключа перед настройкой MCP.

Каталоги и списки MCP

Производственное обнаружение (без аутентификации) — используйте эти URL при отправке в каталоги:

Сторонние индексы (ищите AgentShare или URL вашего листинга):

• Smithery — реестр MCP-серверов

• Glama — каталог MCP / AI-шлюзов

Лицензия

MIT — см. LICENSE.

GitHub — CI и трафик репозитория

• CI: проверяет импорты пакетов MCP при push/PR — Actions → CI.

• Трафик: GitHub показывает только совокупные просмотры/клоны (Insights → Traffic для сопровождающих). Еженедельный снимок трафика GitHub записывает результаты API в Summary запуска (по аналогии с Insights).

Область применения (честно и с прицелом на будущее)

AgentShare агрегирует данные о товарах и предложениях из подключенных маркетплейсов и партнерских источников. Охват и свежесть зависят от источника; API возвращает метаданные свежести (например, crawled_at, data_age_seconds, freshness_status), чтобы агенты могли судить о надежности.

Направление: расширение в сторону глобальной электронной коммерции и крупных международных маркетплейсов по мере развития интеграций. О текущем фокусе см. GET /coverage: https://agentshare.dev/coverage

Юридическая информация

Условия и конфиденциальность: https://agentshare.dev/terms · https://agentshare.dev/privacy