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

이번 레슨에서는

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

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

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

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

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

세 가지 카드, 세 가지 역할

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

API로서의 페이지

허브, 대시보드, 스테이블코인·익스플로러·거래·/freezes 인덱스, 모든 네트워크의 페이지, 그리고 네트워크별 모든 스테이블코인 페이지는 Accept: text/markdown에 응답하며, 프런트매터(title, description, canonical. 허브와 동결 페이지에는 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를 읽고 세 개의 앵커와 각각의 service-desc를 나열합니다.
2. /.well-known/ai-catalog.json을 읽고 세 항목에서 representativeQueries 항목을 하나씩 복사합니다.
3. /.well-known/agent-card.json을 읽습니다. rateLimits를 찾고, skills의 개수를 세고, networks에서 트론(Tron)의 caip2 id를 찾습니다.
4. GET /usdt-explorer.md — USDT 익스플로러의 트윈 — 를 요청하고 프런트매터의 title, canonical, modified를 읽습니다.

레슨 돌아보기

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

다음 내용

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

함께 보기

• 레슨: 접근 경로: llms.txt, agents.md, OpenAPI, 방법론, .md 트윈 · 기계를 위한 Stablecoin scanner ACHIVX
• 레슨: 누가 어디서 무엇을 동결할 수 있는가 · 동결과 알림

더 알아보기

• 에이전트는 어떤 접근 경로를 써야 합니까 — MCP, A2A, REST, 아니면 Markdown 페이지?
• 에이전트는 이 호스트가 제공하는 모든 것을 어떻게 찾습니까?
• 에이전트 카드는 무엇을 선언하며, A2A로 스킬을 어떻게 호출합니까?

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