Agent Onboarding by URLs: Integrate AgentShare Without Reading Docs

자가동적 에이전트는 제품을 '브라우저'로 탐색하지—not—they 는 기계 가독성 있는 엔트립 포인트에서 부팅 (bootstrap) 합니다. 이 글은 AgentShare ( https://agentshare.dev ) 를 위한 URL-first 온보딩 가이드입니다: AI 에이전트를 위한 구조화된 가격 및 오퍼 레이어, 선택적 MCP 지원 포함. 아래 모든 내용은 실제, 라이브, 복사/붙여넣기 가능 . 저는 블로그 포스트를 신뢰하라고 요청하지 않습니다—URL 로 시작하고 확인하세요.

AgentShare 는 무엇을 제공하는가 (정직한 범위)
AgentShare 가 제공하는 것:

• 연결된 소스에서 구조화된 제품 가격 및 오퍼
• JSON REST API 와 선택적 MCP Streamable HTTP
• 큐레이티드 MCP 레지스트리 (가격/오퍼 워크플로우와 잘 맞는 편집자 검토 목록 포함)

현재 초점 (고품질, 일일 업데이트) 은:

• AI 로컬 하드웨어 (Raspberry Pi, Jetson, SBCs)
• 미니 PC, 구성품, 액세서리
• 로봇공학 (키트, 암, 서보)
• 드론 및 로봇/RC 전원 (LiPo, LiFePO4, NiMH)

공식 커버리지 스펙은 공개: GET https://agentshare.dev/coverage
공식 엔트립 포인트: agent.json
이곳에서 시작하세요:
GET https://agentshare.dev/agent.json
거울: GET https://agentshare.dev/.well-known/agentshare.json

이 파일은 온보딩의 단일 진실 (single source of truth) 을 위한 설계되었습니다: 발견 URL, 인증 방법, MCP 엔드포인트, 도구, 범위 포함.

실제 페이로드 (공식 필드)
아래는 agentshare.dev 의 라이브 agent.json 에 기반한 현재 형식의 원문 예시입니다:
{ "schema_version" : "1.0" , "name" : "AgentShare" , "type" : "commerce_price_api" , "description" : "Structured product prices and offers from marketplaces (AI hardware, robotics, drones & robot/RC power) — JSON API plus optional MCP Streamable HTTP." , "base_url" : "https://agentshare.dev" , "human_documentation_url" : "https://agentshare.dev/docs" , "discovery_urls" : { "this_file" : "https://agentshare.dev/agent.json" , "well_known" : "https://agentshare.dev/.well-known/agentshare.json" , "well_known_discovery_index" : "https://agentshare.dev/.well-known/discovery.json" , "mcp_json" : "https://agentshare.dev/mcp.json" , "meta" : "https://agentshare.dev/api/v1/meta" , "agent_capabilities" : "https://agentshare.dev/api/v1/agent-capabilities" , "health" : "https://agentshare.dev/api/v1/health" , "openapi" : "https://agentshare.dev/openapi.json" , "llm_txt" : "https://agentshare.dev/llm.txt" , "mcp_stdio_repo_llms_txt" : "https://raw.githubusercontent.com/anhmtk/agentshare-mcp/main/llms.txt" , "legal_index" : "https://agentshare.dev/legal/index.json" , "coverage" : "https://agentshare.dev/coverage" }, "authentication" : { "type" : "api_key" , "header" : "X-API

• Key: API 키는 /api/v1/search, /api/v1/offers/, /api/v1/products/, MCP /mcp 에 필수입니다. meta, health, agent.json, /mcp.json 에는 불필요합니다.
• signup :
  • register : POST /api/v1/auth/register
  • register_url : https://agentshare.dev/api/v1/auth/register
  • body_json : { email: string, password: string (min 8 chars) }
  • returns : api_key 한 번 (agshp_... 형식과 동일)
• api_version : 1.0.0
• coverage :
  • spec_url : https://agentshare.dev/coverage
  • focus_summary : Focus(고품질, 일일 업데이트): AI 로컬 하드웨어 (Raspberry Pi, Jetson, SBCs), 미니 PC, 부품 및 액세서리, 로봇공학 (키트, 암, 서보), 드론 및 로봇/RC 전원 (LiPo, LiFePO4, NiMH 팩). 확장 중/베타: 스마트폰, 태블릿, 일반 소비자 전자제품, 가전 — 정석 목록: GET /coverage.
• mcp :
  • streamable_http_url : https://agentshare.dev/mcp
  • same_key_as_rest : true
• mcp_listings :
  • positioning : 데이터, 운영, 상거래 관련 도구용 편집자 검토된 커레이션 MCP 레지스트리 — AgentShare 가격 및 오퍼 API 와 함께 사용하도록 설계되었습니다. 일반적인 오픈 디렉터리가 아닙니다.
  • landing : https://agentshare.dev/registry
  • entries_json : https://agentshare.dev/api/v1/registry/entries
  • summary_json : https://agentshare.dev/api/v1/public/mcp-registry/summary
• tools :
  • name: search_products
    • description: 가격 및 신선도 메타데이터를 포함한 소스별 제품 검색
    • method: GET
    • path: /api/v1/search
    • query_params: [q, limit]
    • requires_auth: true
  • name: best_offer
    • description: 쿼리에 대한 최저 재고 오퍼
    • method: GET
    • path: /api/v1/offers/best
    • query_params: [q]
    • requires_auth: true
  • name: best_offer_under_budget
    • description: 최대 가격 아래 최고의 오퍼
    • method: GET
    • path: /api/v1/offers/best-under-budget
    • query_params: [q, max_price]
    • requires_auth: true
  • name: product_detail
    • description: 소스별 가격을 포함한 id 에 대한 제품
    • method: GET
    • path: /api/v1/products/{id}
    • requires_auth: true
  • name: submit_product_url
    • description: 알파: 카탈로그 커버리지 (커뮤니티) 를 위한 마켓플레이스 제품 페이지 URL 제안. JSON 바디: url(필수), notes(선택). 속도 제한; 선택적 X-API-Key 는 시간당 한도를 높입니다.
    • method: POST
    • path: /api/v1/products/submit
    • body_json : { url: string (https 제품 페이지), notes: s

tring (optional)

ent. Per agent.json : same API key as REST same base service You can also discover MCP metadata via: GET https://agentshare.dev/mcp.json OpenAPI (for tool generation) Per discovery URLs: GET https://agentshare.dev/openapi.json Tooling note: some deployments disable interactive docs UI while keeping openapi.json available for machines. Treat OpenAPI as a generation artifact, not the primary discovery system— agent.json is. The curated MCP registry (contributions welcome) AgentShare also maintains a curated MCP registry— editor-reviewed to prevent spam. Landing page: https://agentshare.dev/registry Verified entries (JSON): https://agentshare.dev/api/v1/registry/entries Summary (JSON): https://agentshare.dev/api/v1/public/mcp-registry/summary Why a curated registry? Because agent infra collapses quickly if the directory turns into "everything plus spam". I'd rather ship something smaller, trustworthy, and composable. If you get "no data": here's the right action Coverage is transparent, but real demand is messy. If your agent hits a query that returns nothing, you can help by submitting a specific product URL: POST https://agentshare.dev/api/v1/products/submit (no auth required) Example: curl -s https://agentshare.dev/api/v1/products/submit \ -H "Content-Type: application/json" \ --data-binary "{ " url " : " https://example.com/product-page " , " notes " : " What the agent tried to find and why " }" This helps turn real agent demand into better coverage—without guessing which catalogs to crawl. Founder note (why I built it this way) I'm a founder from Vietnam building an agent-native system with limited resources. My bias is: Ship real endpoints Make everything verifiable by URL Be explicit about coverage Let the community pull the roadmap via real usage If you're building agents and you want a cleaner onboarding story, tell me what's missing. If you find contradictions between this post and live endpoints, that's a bug—please report it. TL;DR (copy/paste URL list) https://agentshare.dev/agent.json https://agentshare.dev/.well-known/discovery.json https://agentshare.dev/llm.txt https://agentshare.dev/api/v1/health https://agentshare.dev/api/v1/meta https://agentshare.dev/api/v1/agent-capabilities https://agentshare.dev/coverage https://agentshare.dev/openapi.json https://agentshare.dev/mcp https://agentshare.dev/mcp.json https://agentshare.dev/api/v1/auth/register https://agentshare.dev/api/v1/products/submit If you want to collaborate on the discover

표준 (agent.json 스키마 형식, .well-known 관습, llms.txt 구조)에 대해 저는 매우 개방적입니다 — 이는 공개적으로 구축해야 할 '에이전트 네이티브 원시'가 바로 그 것입니다.