# 에이전트는 이 호스트가 제공하는 모든 것을 어떻게 찾습니까? 접근 경로 · 두 개의 카탈로그, 하나의 안내판, 하나의 전문 — 추측할 필요 없음 *에이전트용 · 5분 · 고급 · 개발자 · 디스커버리* 네 개의 문서가 호스트를 색인합니다: /.well-known/ai-catalog.json의 AI 카탈로그(에이전트 산출물마다 한 항목: MCP 서버 카드, REST API의 OpenAPI 명세, A2A 에이전트 카드 — 각각 대표 질의 포함), /.well-known/api-catalog의 RFC 9727 API 카탈로그(REST, A2A, MCP와 각각의 문서 및 헬스 체크. REST 항목에는 방법론으로 가는 `service-meta` 링크가 추가됨), 한 페이지 지도인 /llms.txt, 그리고 랜딩 페이지, 스테이블코인 색인, 허브, 모든 네트워크의 스테이블코인 페이지를 하나의 Markdown 문서로 담은 /llms-full.txt입니다. 앱의 모든 HTML 페이지는 Link 헤더와 head에서 카탈로그를 알립니다. ## AI 카탈로그 `GET /.well-known/ai-catalog.json`은 `application/ai-catalog+json`으로 답합니다. 2026-10-13에는 `entries`가 세 개였습니다(2026-10-05 매뉴얼은 여전히 두 개를 나열하며, [OpenAPI](https://achivx.kr/academy/reference/api-methodology/) 항목이 새로 추가된 것입니다): *Stablecoin Scanner MCP server*(유형 `application/mcp-server-card+json`, `/mcp/server-card`를 가리킴), *Stablecoin Scanner REST API (OpenAPI 3.1)*, *Stablecoin Scanner A2A agent*(`application/a2a-agent-card+json`) — 각각 `displayName`, `description`, `identifier`, 그리고 *이 USDT 주소는 동결되었거나 제재 대상입니까*, *베이스의 최근 USDC 전송* 같은 `representativeQueries`를 담고 있습니다. 매뉴얼은 같은 바이트가 `/.well-known/ard.json`으로도 제공되며 *앱의 모든 HTML 페이지가 이를 알린다고 덧붙입니다: `Link` 헤더(`rel="ard"`, `rel="ai-catalog"`, 이어서 기계용 문서를 위한 `service-desc`, `describedby`, `service-doc`)와 `` 안의 `` 태그*. 2026-10-13의 실제 헤더에는 여섯 가지 관계 아래 여덟 개의 링크가 있었고, 세 번째가 `rel="api-catalog"` — 매뉴얼 목록에 언급되지 않은 관계 — 였습니다. `robots.txt`에는 `Agentmap:` 줄이 없습니다. ## API 카탈로그 `GET /.well-known/api-catalog`은 RFC 9727 링크셋입니다(미디어 유형 `application/linkset+json`, 2026-10-13에 캡처한 응답 헤더에서 RFC의 `profile` 매개변수와 함께 전송됨): `/v1`, `/a2a`, `/mcp`에 각각 한 항목씩입니다. 각 항목은 `service-desc`(REST는 [openapi.json](https://stablescan.achivx.com/openapi.json), A2A는 에이전트 카드, [MCP](https://stablescan.achivx.com/mcp)는 서버 카드), `service-doc`([`/agents.md`](https://stablescan.achivx.com/agents.md). REST 항목에는 [`/llms.txt`](https://stablescan.achivx.com/llms.txt)가 추가됨), `status`(`/health`)를 지정합니다. REST 항목만 `service-meta`, [`/v1/methodology`](https://stablescan.achivx.com/v1/methodology)를 담습니다. 이 파일 하나를 읽은 클라이언트는 세 개의 프로토콜 접근 경로와 각각이 선언하는 문서를 알게 됩니다. AI 카탈로그, 전문, 스킬 색인은 여기가 아니라 지도에서 찾습니다. ## 지도와 전문 [`/llms.txt`](https://stablescan.achivx.com/llms.txt)는 안내판입니다 — 네트워크, URL 문법, 기계가 읽을 수 있는 진입점을 각각 한 줄로. `/llms-full.txt`는 그 자체의 표현으로 *이 호스트의 읽을 수 있는 모든 페이지를 Markdown으로 변환해 이어 붙인 것*입니다: 2026-10-13 기준 55,119단어, 46페이지 — 랜딩 대시보드, 스테이블코인 색인, 크로스체인 허브, 각 네트워크의 스테이블코인 페이지 — 크롤링 대신 한 번에 사이트 전체를 읽고 싶은 클라이언트를 위한 것입니다. 사이트맵은 2026-10-13 기준 14개 세그먼트의 색인입니다: 정적 세그먼트 하나, 네트워크마다 페이지 세그먼트 하나, 그리고 그날 기준 솔라나를 제외한 모든 네트워크의 주소 세그먼트. ## 의도적으로 색인하지 않는 것 매뉴얼은 두 가지를 꼽습니다: `/v1/*` 응답에는 `X-Robots-Tag: noindex`가 붙고 `/a2a`는 `robots.txt`에서 금지되어 있습니다. 호스트의 `robots.txt`는 또한 거래, 블록, 주소 조회 페이지를 크롤러에게 닫고, [거래 상대 그래프](https://achivx.kr/academy/guides/counterparty-graph/)와 그 그래프 탐색 경로(`/v1/addresses/{a}/graph`, `/v1/addresses/{a}/walk`)를 이름이 지정된 세 검색 봇에게 닫습니다 — 크롤러 관리일 뿐, 에이전트에 대한 규칙이 아닙니다. 매뉴얼: *둘 다 접근 규칙이 아닙니다. 크롤러에게 JSON을 페이지처럼 색인하지 말라고 요청할 뿐입니다. 직접 호출하십시오.* ## Stablecoin scanner ACHIVX에서 [AI 카탈로그 열기 ↗](https://stablescan.achivx.com/.well-known/ai-catalog.json) - AI 카탈로그: [/.well-known/ai-catalog.json](https://stablescan.achivx.com/.well-known/ai-catalog.json). API 카탈로그: [/.well-known/api-catalog](https://stablescan.achivx.com/.well-known/api-catalog). - 지도: [/llms.txt](https://stablescan.achivx.com/llms.txt). 전문: [/llms-full.txt](https://stablescan.achivx.com/llms-full.txt). ## 출처 - [AI 카탈로그](https://stablescan.achivx.com/.well-known/ai-catalog.json) - [API 카탈로그 (RFC 9727 링크셋)](https://stablescan.achivx.com/.well-known/api-catalog) - [llms.txt — 호스트의 한 페이지 지도](https://stablescan.achivx.com/llms.txt) - [llms-full.txt — 랜딩 페이지, 스테이블코인 색인, 허브, 모든 네트워크의 스테이블코인 페이지를 하나의 Markdown 문서로](https://stablescan.achivx.com/llms-full.txt) - [에이전트 매뉴얼 — agents.md (버전 2026-10-05)](https://stablescan.achivx.com/agents.md) ## 더 알아보기 - [레슨: 접근 경로, 카드, 카탈로그](https://achivx.kr/academy/courses/the-scanner-for-agents/the-scanner-for-agents-01-the-doors-and-the-cards/) - [기계로 사이트 읽기](https://achivx.kr/academy/reference/api-methodology/) ## 관련 질문 - [에이전트는 어떤 접근 경로를 써야 합니까 — MCP, A2A, REST, 아니면 Markdown 페이지?](https://achivx.kr/academy/for-agents/which-door-for-an-agent/) - [페이지가 곧 API입니다: 페이지를 Markdown으로 어떻게 읽습니까?](https://achivx.kr/academy/for-agents/pages-are-an-api/) - [에이전트 카드는 무엇을 선언하며, A2A로 스킬을 어떻게 호출합니까?](https://achivx.kr/academy/for-agents/what-the-agent-card-declares/) 접근 경로 · 디스커버리 · 2026-10-13 작성, 스캐너 자체의 기계용 문서와 그날 조회한 실시간 응답을 바탕으로 했습니다. 구조는 그대로 인용했으며, 수치는 날짜 기준이고 인덱스에 따라 바뀝니다. --- 출처: https://achivx.kr/academy/for-agents/how-an-agent-discovers-the-host/ · 영어 원문: https://achivx.com/academy/for-agents/how-an-agent-discovers-the-host.html