# 접근 경로, 카드, 카탈로그

접근 경로와 봉투

*레슨 1/5 · 12분 · 고급 · 개발자*

## 이번 레슨에서는

레슨을 마치면 다음을 할 수 있습니다.

- 두 카탈로그와 에이전트 카드를 읽고, 모든 접근 경로 나열하기
- 서버 카드, 에이전트 카드, 스킬 색인 구분하기
- 어느 페이지가 Markdown으로 변환되고 어느 페이지가 변환되지 않는지 알기

## URL 하나, 그다음은 추측 없이

설명서의 첫 줄은 *누군가 URL 하나를 건네며 더 이상의 사람 개입 없이 스테이블코인 텔레메트리를 다루라고 지시한* 에이전트에게 쓰여 있습니다. 그 URL에서 지도, 두 카탈로그, 설명서가 호스트를 열어 주며, 어느 것에도 키가 필요하지 않습니다.

| 문서 | 응답 형식 | 제공하는 것 |
|---|---|---|
| [`/llms.txt`](https://stablescan.achivx.com/llms.txt) | `text/plain` | 일곱 개 네트워크와 그 슬러그, URL 문법, 모든 기계용 파일을 각각 한 줄로 |
| `/.well-known/ai-catalog.json` | `application/ai-catalog+json` | 에이전트 산출물마다 항목 하나 — `MCP` 서버 카드, REST API 설명([openapi.json](https://stablescan.achivx.com/openapi.json)), A2A 에이전트 카드 — 각각 대표 질의 포함 |
| `/.well-known/api-catalog` | `application/linkset+json` (RFC 9727) | REST, A2A, [MCP](https://stablescan.achivx.com/mcp) 각각의 설명, 문서, `/health`. REST 항목에만 [`/v1/methodology`](https://stablescan.achivx.com/v1/methodology)가 추가됨 |
| [`/agents.md`](https://stablescan.achivx.com/agents.md) | `text/markdown` | 서술형 설명서. 버전 관리되며, 파서를 점검할 수 있는 변경 기록 포함 |

모든 HTML 페이지는 `Link` 헤더와 `<link>` 태그로 카탈로그를 알리므로, 어느 페이지에 도착한 크롤러든 같은 진입로를 찾습니다.

## 세 가지 카드, 세 가지 역할

**에이전트 카드**([`/.well-known/agent-card.json`](https://stablescan.achivx.com/.well-known/agent-card.json), 1.4.0)는 *스키마와 한도에 관한 권위 있는 기준*입니다. 입력 스키마가 있는 스킬 여덟 개, JSON-RPC 엔드포인트, CAIP-2 id가 붙은 네트워크, 요청 한도, `x-mcp` 포인터, 그리고 [Markdown 트윈](https://achivx.kr/academy/courses/the-scanner-for-machines/the-scanner-for-machines-01-the-doors/)과 함께 명시된 페이지 아홉 개가 들어 있습니다. **MCP 서버 카드**(`/mcp/server-card`)는 연결 줄, 전송 방식, 프로토콜 버전을 담고 있으며, 도구 목록은 없습니다. 도구 목록은 `initialize` 뒤의 `tools/list`에서 얻습니다. **스킬 색인**(`/.well-known/agent-skills/index.json`)은 코딩 에이전트를 위한 SKILL.md 절차 세 개를 각각의 다이제스트와 함께 나열하며, `npx skills add https://stablescan.achivx.com`으로 설치합니다.

## API로서의 페이지

허브, 대시보드, 스테이블코인·익스플로러·거래·[`/freezes`](https://stablescan.achivx.com/freezes) 인덱스, 모든 네트워크의 페이지, 그리고 네트워크별 모든 스테이블코인 페이지는 `Accept: text/markdown`에 응답하며, 프런트매터(title, description, canonical. 허브와 [동결 페이지](https://achivx.kr/academy/courses/freezes-and-alerts/freezes-and-alerts-01-who-can-freeze-what/)에는 `modified`도 포함)가 있는 `.md` 트윈을 제공합니다. 주소, 거래, `/block/` 페이지는 HTML 전용입니다. *200을 받았다고 해서 Markdown을 받았다는 증거로 여기지 마십시오*. `/llms-full.txt`는 랜딩 페이지, 스테이블코인 인덱스, 허브, 그리고 모든 네트워크의 스테이블코인 페이지를 하나의 파일에 담고 있습니다. 2026-10-13 기준 46페이지, 55,119단어입니다.

## 핵심 정리

- `/llms.txt`에서 시작하십시오. 모든 문서를 밝히며, API 카탈로그는 모든 접근 경로를 밝힙니다
- 에이전트 카드는 스키마와 한도에 관한 권위 있는 기준이고, 설명서는 서술입니다
- 서버 카드에는 도구 목록이 없습니다. initialize하고, 세션 id를 보관한 다음, tools/list를 호출하십시오
- SKILL.md 절차 세 개는 npx 한 줄로 설치되며, 각각 설명서를 다시 가리킵니다
- 주소, 거래, 블록 페이지에는 Markdown 변환이 없고, 나머지 대부분의 페이지에는 있습니다

## Stablecoin scanner ACHIVX에서 직접 해 보기

1. [/.well-known/api-catalog](https://stablescan.achivx.com/.well-known/api-catalog)를 읽고 세 개의 앵커와 각각의 `service-desc`를 나열합니다.
2. [/.well-known/ai-catalog.json](https://stablescan.achivx.com/.well-known/ai-catalog.json)을 읽고 세 항목에서 `representativeQueries` 항목을 하나씩 복사합니다.
3. [/.well-known/agent-card.json](https://stablescan.achivx.com/.well-known/agent-card.json)을 읽습니다. `rateLimits`를 찾고, `skills`의 개수를 세고, `networks`에서 트론(Tron)의 `caip2` id를 찾습니다.
4. `GET /usdt-explorer.md` — [USDT 익스플로러의 트윈](https://stablescan.achivx.com/usdt-explorer.md) — 를 요청하고 프런트매터의 `title`, `canonical`, `modified`를 읽습니다.

## 레슨 돌아보기

- 지도, 두 카탈로그, 설명서 중 런타임이 가장 먼저 읽을 것은 무엇이며, 그 이유는 무엇입니까?
- `Accept: text/markdown`에 200과 HTML로 응답하는 페이지를 클라이언트는 어떻게 처리하겠습니까?

## 다음 내용

모든 접근 경로는 같은 질문에 답합니다. 다음은 같은 스킬을 MCP, A2A, REST로 호출하고, 같은 답을 세 가지 봉투에서 읽는 방법입니다.

## 함께 보기

- 레슨: [접근 경로: llms.txt, agents.md, OpenAPI, 방법론, .md 트윈 · 기계를 위한 Stablecoin scanner ACHIVX](https://achivx.kr/academy/courses/the-scanner-for-machines/the-scanner-for-machines-01-the-doors/)
- 레슨: [누가 어디서 무엇을 동결할 수 있는가 · 동결과 알림](https://achivx.kr/academy/courses/freezes-and-alerts/freezes-and-alerts-01-who-can-freeze-what/)

## 더 알아보기

- [에이전트는 MCP, A2A, REST, Markdown 페이지 중 어느 접근 경로를 써야 합니까?](https://achivx.kr/academy/for-agents/which-door-for-an-agent/)
- [에이전트는 이 호스트가 제공하는 모든 것을 어떻게 찾아냅니까?](https://achivx.kr/academy/for-agents/how-an-agent-discovers-the-host/)
- [에이전트 카드는 무엇을 선언하며, A2A로 스킬을 어떻게 호출합니까?](https://achivx.kr/academy/for-agents/what-the-agent-card-declares/)

레슨 1/5 · 에이전트를 위한 Stablecoin scanner ACHIVX · 위에 링크된 사용자 가이드를 바탕으로 합니다.

---

출처: https://achivx.kr/academy/courses/the-scanner-for-agents/the-scanner-for-agents-01-the-doors-and-the-cards/ · 영어 원문: https://achivx.com/academy/courses/the-scanner-for-agents/the-scanner-for-agents-01-the-doors-and-the-cards.html