AgentPort 가상
등재 요청

API 안내

디렉터리 데이터를 JSON 으로 — 읽기 전용, 키 하나.

기준 주소https://api.agentport.example/v1
API 목차 9

시작하기

모든 요청은 GET 이고, 응답은 UTF-8 JSON 입니다. 키는 무료이고 이메일 주소 하나에 하나씩 드립니다.

  1. 1

    문의 쪽에서 ‘API 키’ 주제로 쓰려는 곳을 적어 보내면 키를 메일로 받습니다.

  2. 2

    요청마다 Authorization: Bearer <키> 헤더를 붙입니다. 키를 코드에 적지 말고 환경 변수에 두세요.

  3. 3

    합계부터 불러 보면 키가 맞는지 바로 압니다.

터미널 — 첫 요청
curl https://api.agentport.example/v1/stats \
  -H "Authorization: Bearer $AGENTPORT_KEY"

엔드포인트

메서드경로하는 일한도(무료)
GET/v1/servers서버 목록 — 검색 · 거르기 · 정렬 · 쪽60/분
GET/v1/servers/{slug}서버 하나 — 도구 · 설치 · 지원 클라이언트60/분
GET/v1/clients클라이언트와 지원 기능 7가지60/분
GET/v1/stats합계와 최근 주별 새 서버10/분

GET/v1/servers

등재 서버 2,418개를 30개씩 돌려줍니다. 디렉터리 쪽의 검색·거르기·정렬과 같은 값을 씁니다.

매개변수

이름형식설명기본
q문자열이름 · 설명 · 범주에서 찾기—
categoryslug범주 12개 중 하나 — 예: files전체
hostlocal · remote호스팅전체
langts · py · go · rust · other언어전체
sortrecommended · recent · hot-week · hot-all · name정렬recommended
page정수1부터1
per_page정수 1–100한 쪽의 수30

요청 예시

터미널
curl "https://api.agentport.example/v1/servers?sort=hot-week" \
  -H "Authorization: Bearer $AGENTPORT_KEY"

응답

200 OK — application/json
{
  "total": 2418,
  "page": 1,
  "per_page": 30,
  "sort": "hot-week",
  "items": [
    {
      "port": 1031,
      "slug": "file-keeper",
      "name": "파일 정리함",
      "category": "files",
      "lang": "ts",
      "host": "local",
      "class": "official",
      "tools": 11,
      "visits_week": 41200,
      "registered": "2024-11-21"
    },
    {
      "port": 2976,
      "slug": "browser-hand",
      "name": "브라우저 손",
      "category": "browser",
      "lang": "ts",
      "host": "remote",
      "class": "community",
      "tools": 14,
      "visits_week": 36800,
      "registered": "2026-06-23",
      "endpoint": "https://browser-hand.example/mcp"
    }
  ]
}

GET/v1/servers/{slug}

서버 하나의 상세 — 상세 쪽에 보이는 도구 목록 · 설치 명령 · 지원 클라이언트 요약을 돌려줍니다.

요청 예시

터미널
curl "https://api.agentport.example/v1/servers/file-keeper" \
  -H "Authorization: Bearer $AGENTPORT_KEY"

응답

200 OK — application/json
{
  "port": 1031,
  "slug": "file-keeper",
  "name": "파일 정리함",
  "version": "v2.4.1",
  "transport": ["stdio"],
  "tools": [
    "read", "write", "list", "move", "copy", "find",
    "stat", "mkdir", "tree", "compare", "trash"
  ],
  "install": {
    "command": "npx",
    "args": ["-y", "@osolgil/file-keeper"]
  },
  "clients": { "supported": 4, "partial": 2, "checked": "2026-09-24" },
  "rank_week": 1
}

GET/v1/clients

클라이언트 164개와 지원 기능 7가지. 값은 yes · partial · no · unknown 넷입니다(v1.3).

터미널
curl "https://api.agentport.example/v1/clients?platform=desktop" \
  -H "Authorization: Bearer $AGENTPORT_KEY"
200 OK — application/json
{
  "total": 164,
  "items": [
    {
      "port": 7012,
      "slug": "deungdae-desk",
      "name": "등대 데스크",
      "platform": "desktop",
      "features": {
        "tools": "yes",
        "resources": "yes",
        "prompts": "yes",
        "sampling": "partial",
        "roots": "yes",
        "remote": "yes",
        "oauth": "yes"
      },
      "checked": "2026-09-24"
    }
  ]
}

GET/v1/stats

통계 쪽의 숫자와 같습니다. 매주 월요일 아침에 갱신합니다.

200 OK — application/json
{
  "updated": "2026-09-26",
  "servers": 2418,
  "servers_week": 37,
  "servers_12w": 412,
  "clients": 164,
  "apps": 38,
  "remote_share": 0.380,
  "visits_week": 486200,
  "tools_avg": 7.4,
  "weekly_new": [33, 29, 41, 37]
}

한도

한도를 넘으면 429 와 함께 Retry-After 헤더로 몇 초 뒤에 다시 부를지 알려 줍니다.

등급분당하루받는 법
무료6010,000문의 쪽에서 바로
파트너600200,000쓰는 곳을 알려 주면 편집부가 검토

오류 코드

코드이름뜻
400bad_request매개변수 값이 틀렸다 — 예: 없는 범주
401unauthorized키가 없거나 틀렸다
404not_found그런 slug 의 서버가 없다 — 보관된 서버도 여기
429rate_limited한도를 넘었다 — Retry-After 초만큼 기다린다
404 — 오류 본문
{
  "error": "not_found",
  "message": "no server with slug 'file-keepr'",
  "hint": "did you mean 'file-keeper'?"
}

변경 기록

  1. v1.32026-08-27추가/v1/clients 에 지원 기능 7가지 필드를 더했다
  2. v1.22026-02-10추가/v1/stats 를 열었다 — 통계 쪽과 같은 숫자
  3. v1.12025-11-03고침정렬 name 이 한글 가나다순을 따르게 고쳤다
  4. v1.02025-08-18추가첫 공개 — 서버 목록과 상세