# 접근 경로: llms.txt, agents.md, OpenAPI, 방법론, .md 트윈

접근 경로와 규칙

*레슨 1/3 · 10분 · 고급 · 애널리스트 · 개발자*

## 이번 레슨에서는

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

- 무엇이 제공되는지 나열하고 올바른 접근 경로에서 시작하기
- 구속력 있는 두 가지 규칙 말하기
- /v1/methodology를 한 번은 읽어야 하는 이유 알기

## 설명서가 아닌 이정표

스캐너는 자체 개발자 문서를 게시하며, 이 문서는 버전이 관리되고 배포된 내용과 함께 갱신됩니다. 이를 이 페이지들에 복사하면 점점 어긋나는 두 번째 버전이 생길 것입니다. 그래서 이 레슨은 이정표입니다. 사이트를 사용하는 데는 이 중 어느 것도 필요하지 않습니다. **직접 하던 확인을 자동화**하거나 스캐너를 에이전트에 넘겨줄 때 중요해집니다.

| 접근 경로 | 무엇인가 |
|---|---|
| **`/llms.txt`** | 기계가 읽을 수 있는 모든 영역의 색인. **여기서 시작하십시오** |
| **`/agents.md`** | [에이전트 설명서](https://achivx.kr/academy/reference/api-methodology/): 스캐너가 무엇에 답하는지, 어느 경로가 답하는지, 그 주변 생태계. 버전 관리, 약 900줄 |
| **`/openapi.json`** | 모든 `/v1` 경로와 그 매개변수 및 오류 코드에 대한 [OpenAPI](https://achivx.kr/academy/reference/api-methodology/) 3.1 |
| **`/v1/methodology`** | 스캐너의 *의미*: 원칙, 정의, 제외 사항, 한도, 탐지 신호, 그리고 질문 → 경로 지도 |
| **MCP · A2A · 에이전트 스킬** | 에이전트 프로토콜 영역이며, [`/llms.txt`](https://stablescan.achivx.com/llms.txt)에 URL과 함께 나열되어 있음 |
| **`.md` 트윈** | 대부분의 페이지는 같은 경로에 `.md`를 붙여 제공됨 — [네트워크 페이지](https://achivx.kr/academy/courses/first-steps/first-steps-03-the-dashboard/), [토큰 페이지](https://achivx.kr/academy/courses/following-the-stablecoins/following-the-stablecoins-03-token-pages/), [익스플로러](https://achivx.kr/academy/courses/following-the-stablecoins/following-the-stablecoins-04-the-explorers/), [피드](https://achivx.kr/academy/courses/following-the-stablecoins/following-the-stablecoins-01-settlement-tables/), [동결 페이지](https://achivx.kr/academy/courses/freezes-and-alerts/freezes-and-alerts-01-who-can-freeze-what/). [주소 페이지](https://achivx.kr/academy/courses/reading-an-address/reading-an-address-01-the-reading-order/)와 첫 페이지는 제공되지 않음 |

## 모든 이용자를 구속하는 두 가지 규칙

[관심 목록(watchlist)](https://achivx.kr/academy/courses/freezes-and-alerts/freezes-and-alerts-04-alerts/)을 제외하면 **익명이며 읽기 전용**입니다. IP별 요청 한도가 적용되므로 백오프를 고려해 설계하십시오. **한도를 밝히는 필드를 존중하십시오**. `frontier_truncated`, [상한](https://achivx.kr/academy/courses/the-scanner-for-machines/the-scanner-for-machines-02-limits/)에 걸린 합계, `unknown` 분류, 값이 없는 것은 버려도 되는 메타데이터가 아니라 답의 일부입니다. `unknown`을 “깨끗함”으로 표시하는 통합 시스템은 스캐너가 말하기를 거부한 것을 게시한 셈입니다.

## /v1/methodology를 한 번은 읽어야 하는 이유

인터페이스의 약속이 암시되는 대신 명문화된 곳이기 때문입니다. *unknown은 깨끗함이 아니라는 것*, 새 탐지기는 기준을 통과할 때까지 그림자 모드로 실행된다는 것, 자기 신고 라벨과 검증된 라벨은 결코 하나의 등급으로 합쳐지지 않는다는 것이 그것입니다. 가이드가 쉬운 말로 설명하는 여러 규칙은 이 엔드포인트의 것이며, 그곳에 그 엔드포인트 자신의 말로 적혀 있습니다. 가이드: [기계로 사이트 읽기](https://achivx.kr/academy/reference/api-methodology/).

## 핵심 정리

- /llms.txt에서 시작하십시오. 에이전트 설명서는 /agents.md, 경로는 /openapi.json에 있습니다
- /v1/methodology는 의미입니다: 원칙, 정의, 한도, 질문 → 경로
- 익명, 읽기 전용, 요청 한도 적용 — 백오프를 고려해 설계하십시오
- 한도 필드는 답의 일부이며, 이를 버리면 거짓 주장을 게시하게 됩니다
- 주소 페이지와 첫 페이지에는 .md 트윈이 없고, 나머지 대부분의 페이지에는 있습니다

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

1. [/llms.txt](https://stablescan.achivx.com/llms.txt)를 열고 그것이 색인하는 영역을 나열합니다.
2. [/v1/methodology](https://stablescan.achivx.com/v1/methodology)를 열고 *unknown*에 관한 문장을 찾습니다. 그다음 질문 → 경로 지도를 찾습니다.
3. [이더리움 대시보드](https://stablescan.achivx.com/ethereum)(`/ethereum`) 옆에 [/ethereum.md](https://stablescan.achivx.com/ethereum.md)를 열고, 트윈이 무엇을 담고 무엇을 빼는지 기록합니다.

## 레슨 돌아보기

- 지금 손으로 하는 확인 중 경로 하나가 답해 줄 수 있는 것은 무엇입니까?
- 파이프라인의 어느 지점에서 버려진 `frontier_truncated`가 거짓 *clean*(깨끗함)으로 바뀌겠습니까?

## 다음 내용

모든 경로는 상한이 걸린 숫자를 반환합니다. 다음은 하나의 표에 모은 모든 상한과, 각각이 숫자의 의미를 어떻게 바꾸는지입니다.

## 함께 보기

- 가이드: [기계로 사이트 읽기](https://achivx.kr/academy/reference/api-methodology/)
- 레슨: [대시보드: 네 개의 수치와 기간 · Stablecoin scanner ACHIVX: 첫걸음](https://achivx.kr/academy/courses/first-steps/first-steps-03-the-dashboard/)
- 레슨: [토큰 페이지와 Contract 탭 · 스테이블코인 추적: 행, 거래, 토큰](https://achivx.kr/academy/courses/following-the-stablecoins/following-the-stablecoins-03-token-pages/)
- 레슨: [USDT 및 USDC 익스플로러 · 스테이블코인 추적: 행, 거래, 토큰](https://achivx.kr/academy/courses/following-the-stablecoins/following-the-stablecoins-04-the-explorers/)
- 레슨: [정산 테이블: 행 읽기와 페이지 넘기기 · 스테이블코인 추적: 행, 거래, 토큰](https://achivx.kr/academy/courses/following-the-stablecoins/following-the-stablecoins-01-settlement-tables/)
- 레슨: [누가 어디서 무엇을 동결할 수 있는가 · 동결과 알림](https://achivx.kr/academy/courses/freezes-and-alerts/freezes-and-alerts-01-who-can-freeze-what/)
- 레슨: [주소 페이지를 읽는 순서 · 주소 읽기](https://achivx.kr/academy/courses/reading-an-address/reading-an-address-01-the-reading-order/)
- 레슨: [텔레그램과 API를 통한 알림 · 동결과 알림](https://achivx.kr/academy/courses/freezes-and-alerts/freezes-and-alerts-04-alerts/)
- 레슨: [한도: 모든 상한과 그 의미 · 기계를 위한 Stablecoin scanner ACHIVX](https://achivx.kr/academy/courses/the-scanner-for-machines/the-scanner-for-machines-02-limits/)
- 가이드: [기계로 사이트 읽기](https://achivx.kr/academy/reference/api-methodology/)

## 더 알아보기

- [스크립트나 AI 에이전트로 주소를 자동 확인하려면 어떻게 합니까?](https://achivx.kr/academy/how-it-works/how-to-check-an-address-automatically/)
- [Stablecoin scanner ACHIVX는 어떤 네트워크와 스테이블코인을 인덱싱합니까?](https://achivx.kr/academy/how-it-works/which-networks-and-coins/)

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

---

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