AgentShare

AI 에이전트를 위한 구조화된 마켓플레이스 가격 및 제안 — REST API 및 MCP (Streamable HTTP).

이 저장소는 Claude Desktop, Cursor 및 기타 MCP 클라이언트와 함께 사용되는 stdio MCP 서버와 최소한의 REST 예제를 포함합니다. 라이브 API 및 전체 통합 가이드는 위 사이트에서 확인할 수 있습니다.

AI 에이전트용 (기계 판독 가능)

• AGENTS.md — 미션, 도구 이름, 인증, 응답 엔벨로프, 복사-붙여넣기용 MCP JSON 및 OpenAPI 링크.

• llms.txt — 짧고 크롤링하기 쉬운 단일 파일로 된 동일한 핵심 정보 (LLM / GEO 워크플로우용).

• openapi.json — 이 MCP에서 사용하는 REST 인터페이스(/api/v1/search, /offers/*, /meta)에 대한 OpenAPI 3.0 사양. 전체 프로덕션 사양(모든 경로)은 항상 **https://agentshare.dev/openapi.json**에서 확인할 수 있습니다 (단일 진실 공급원; 중복 문서 저장소 없음).

• mcp-config.json — 원격 Streamable HTTP 엔드포인트를 가리키는 npx mcp-remote(Claude Desktop / Cursor)용 복사-붙여넣기 가능한 mcpServers 블록.

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 키 헤더를 지원하는 클라이언트는 X-API-Key 또는 Authorization: Bearer와 함께 https://agentshare.dev/mcp/를 사용할 수 있습니다. **npx mcp-remote**에는 **mcp-config.json**을 사용하세요. 세부 정보: MCP 퀵스타트 (MCP 섹션).

고급 — mcp-remote를 통한 HTTP (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: 푸시/PR 시 MCP 패키지 가져오기를 검증합니다 — 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