# 페이지가 곧 API입니다: 페이지를 Markdown으로 어떻게 읽습니까?

접근 경로 · 같은 문서, 마크업 부담 없이 — 변환본이 있는 페이지에 한해

*에이전트용 · 4분 · 고급 · 개발자 · 변환본*

허브, 랜딩 페이지, 스테이블코인·익스플로러·거래·동결 색인, 모든 네트워크 페이지, 모든 네트워크별 스테이블코인 페이지는 `Accept: text/markdown`에 같은 문서의 Markdown 변환본으로 답하며, `.md` 쌍둥이 URL에서도 제공됩니다. 프런트매터에는 제목, 설명, 정식 URL이 있고 응답에는 ETag가 붙습니다. 주소, 거래, 블록 페이지는 HTML 전용입니다 — 그곳의 200은 Markdown이라는 증거가 아닙니다.

## 어떤 페이지에 변환본이 있습니까

매뉴얼 §3 *페이지가 곧 API입니다*: *허브, 랜딩 페이지, `/stablecoin`, `/explorers`, `/transactions`, `/freezes` 색인, 모든 네트워크 페이지(`/{network}`, `/{network}/transactions`, `/{network}/freezes`), 모든 `/{network}/stablecoin/{symbol}` 페이지는 `Accept: text/markdown`에 같은 문서의 Markdown 변환본으로 답합니다 — `.md` 쌍둥이 URL(`/index.md`, `/usdt-explorer.md`, `/ethereum/freezes.md`, `/{network}/stablecoin/{symbol}.md`, …)에서도 제공됩니다*. 에이전트 카드의 `pages` 목록은 그중 아홉 개를 Markdown URL과 함께 지정합니다: [대시보드](https://achivx.kr/academy/guides/dashboard/)(`/index.md`), 스테이블코인 색인(`/stablecoin.md`), 그리고 [/explorers](https://stablescan.achivx.com/explorers)에 나열된 일곱 개의 익스플로러 허브. `llms.txt`의 Markdown 줄은 더 짧은 집합을 지정합니다 — 허브, 랜딩 페이지, `/stablecoin`, 네트워크별 스테이블코인 페이지. 완전한 목록은 매뉴얼의 것이며, [`/ethereum/freezes.md`](https://stablescan.achivx.com/ethereum/freezes.md)는 2026-10-13에 Markdown으로 답했습니다.

## 변환본에 담기는 것

*프런트매터에는 페이지 제목, 설명, 정식 URL이 있습니다. 허브와 동결 페이지의 프런트매터에는 표시된 수치의 빌드 스탬프인 `modified`도 있습니다 — 허브에서는 24h 블록의 스탬프이며, `Last-Modified`는 가장 최근 블록을 따릅니다.* 2026-10-13 [USDT 익스플로러](https://achivx.kr/academy/guides/usdt-explorer/)의 쌍둥이에서 두 값은 그 문장이 예측하는 대로 15분 차이가 났습니다. 허브의 기간 전환 — `?window=24h|7d|30d` — 은 네트워크별 표만 바꾸며 다른 것은 바꾸지 않고, `.md` 쌍둥이도 이를 따릅니다. 매개변수 없는 URL의 표는 `30d`입니다. 응답에는 ETag가 붙으므로 클라이언트는 `If-None-Match`로 재검증할 수 있습니다. 매뉴얼의 조언: *웹 페이지를 읽을 수 있다면 변환본을 선호하십시오: 같은 숫자, 마크업 부담 없음.*

## 변환본이 없는 것

*변환본은 그 페이지들에만 있습니다 — 주소/거래/블록 페이지는 HTML 전용입니다(그곳에서 `Accept: text/markdown`은 여전히 HTML과 함께 200으로 답하므로, 200을 markdown을 받았다는 증거로 삼지 마십시오).* 증거는 응답의 `Content-Type: text/markdown`이며, 2026-10-13에 읽은 두 쌍둥이 모두 이를 담고 있었습니다. 주소는 대신 API의 주소 응답으로 읽습니다. 거래는 `GET /v1/transfers?tx={hash}&chain=`로, 또는 해시만 갖고 있다면 `GET /v1/verify?tx={hash}`로 읽습니다 — 둘 다 [get-recent-transactions는 무엇을 반환합니까?](https://stablescan.achivx.com/docs/user/for-agents/get-recent-transactions.html)에 있습니다. HTML 페이지 자체는 여전히 사람을 위해 해시를 찾아 줍니다: *`/{network}/tx/{hash}` 페이지는 그 해시를 가진 인덱싱된 네트워크가 어디든 찾아내며, 그 `<link rel=canonical>`과 `og:url`은 그 네트워크를, 그 네트워크의 표기 방식으로 쓴 해시와 함께 지정합니다.*

## URL 문법

*URL은 네트워크가 먼저입니다 — `/{network}/{entity}/{key}`, entity ∈ `stablecoin`, `address`, `tx`, `block`. 예: `/base/stablecoin/usdc`.* 네트워크 슬러그는 카드의 `networks[].slug`, 또는 `/v1/networks`의 `settled: true` 행입니다(`settled: false` 행은 알려져 있지만 여기서 인덱싱되지 않으며, `chain` 값으로 쓰면 그 슬러그는 거부됩니다): `ethereum`, `tron`, `bnb-chain`, `solana`, `base`, `optimism`, `arbitrum`.

## Stablecoin scanner ACHIVX에서

[이더리움 대시보드를 Markdown으로 열기 ↗](https://stablescan.achivx.com/ethereum.md)

- 페이지 옆의 쌍둥이: [/ethereum.md](https://stablescan.achivx.com/ethereum.md), [/usdt-explorer.md](https://stablescan.achivx.com/usdt-explorer.md), [/ethereum/freezes.md](https://stablescan.achivx.com/ethereum/freezes.md).
- 에이전트 카드가 Markdown URL과 함께 지정하는 아홉 페이지: [/.well-known/agent-card.json](https://stablescan.achivx.com/.well-known/agent-card.json).

## 출처

- [에이전트 매뉴얼 — agents.md (버전 2026-10-05)](https://stablescan.achivx.com/agents.md)
- [A2A 에이전트 카드 (1.4.0)](https://stablescan.achivx.com/.well-known/agent-card.json)
- [llms.txt — 호스트의 한 페이지 지도](https://stablescan.achivx.com/llms.txt)

## 더 알아보기

- [레슨: 접근 경로, 카드, 카탈로그](https://achivx.kr/academy/courses/the-scanner-for-agents/the-scanner-for-agents-01-the-doors-and-the-cards/)
- [가이드: USDT 익스플로러](https://achivx.kr/academy/guides/usdt-explorer/)

## 관련 질문

- [에이전트는 이 호스트가 제공하는 모든 것을 어떻게 찾습니까?](https://achivx.kr/academy/for-agents/how-an-agent-discovers-the-host/)
- [페이지 나누기와 캐시는 어떻게 합니까: 커서, ETag, If-None-Match?](https://achivx.kr/academy/for-agents/how-to-page-and-cache/)
- [에이전트는 어떤 접근 경로를 써야 합니까 — MCP, A2A, REST, 아니면 Markdown 페이지?](https://achivx.kr/academy/for-agents/which-door-for-an-agent/)

접근 경로 · 변환본 · 2026-10-13 작성, 스캐너 자체의 기계용 문서와 그날 조회한 실시간 응답을 바탕으로 했습니다. 구조는 그대로 인용했으며, 수치는 날짜 기준이고 인덱스에 따라 바뀝니다.

---

출처: https://achivx.kr/academy/for-agents/pages-are-an-api/ · 영어 원문: https://achivx.com/academy/for-agents/pages-are-an-api.html