AI에게 「발견되기」 위해, API에 Markdown을 배치한 이야기

── llms.txt・JPYC x402・인보이스 제도(Invoice System)를 통해 알게 된 것

서론

API를 만들어도, AI가 발견해주지 못하면 의미가 없다.

인간을 위한 서비스라면 SEO나 SNS를 통해 퍼뜨리는 방법이 있다. 하지만 AI 에이전트(AI Agent)를 위한 API는 어떻게 「존재」를 알려야 할까.

오늘은 그 답을 찾는 과정에서 깨달은 점을 적는다.

AI는 예쁜 사이트를 보지 않는다

어떤 기사를 읽고 인식이 바뀌었다.

AI 에이전트가 API를 선택할 때, 인간과 마찬가지로 LP(Landing Page)나 설명 페이지를 읽는 것이 아니다.

AI가 실제로 읽는 것은 다음과 같은 파일들이다.

• llms.txt (이 API에 무엇이 있는지에 대한 목차)
• skill.md (이 API로 무엇을 할 수 있는지에 대한 짧은 설명)
• openapi.yaml (엔드포인트(Endpoint)・입력・출력 사양)
• examples.md (사용법 샘플)

즉, 예쁜 HTML 사이트보다 심플한 Markdown이 AI에게는 더 효과적이다.

이 사실을 알고 바로 움직였다.

10개의 API에 Markdown을 추가했다

나는 AI 에이전트용 API를 10개 만들고 있다.

하지만 솔직히 llms.txt도 skill.md도 배치하지 않은 API가 대부분이었다.

오늘, 총 10개 모두에 아래 내용을 추가했다.

• llms.txt
• skill.md
• openapi.yaml (미작성 상태였던 7개)

작업은 Claude Code에 지시를 내려 일괄 실행했다. 하루 만에 전부 끝났다.

llms.txt에 적은 것

AI에게 「언제 사용하는지」를 전달하는 것이 중요하다.

예를 들어 agent-budget-guard의 llms.txt에는 이렇게 적었다.

# Agent Budget Guard API
Check AI agent payment before x402 transaction.
## Best for
...

「무엇을 하는가」뿐만 아니라 「언제 사용하는가」, 「사용하지 않는 상황」을 적는다. 이것이 AI에게 선택받기 위한 작성법이다.

JPYC x402 시장이 움직이기 시작했다

같은 날, 또 하나의 중요한 움직임을 알게 되었다.

JPYC x402 결제가 Polygon mainnet에서 Coinbase CDP Facilitator를 통해 실제로 작동했다.

지금까지는 「JPYC로 x402를 하려면 자체 제작한 Facilitator가 필요하다」는 상황이었다. 그것이 CDP를 통해 가능해진 것이다.

즉, 다음에 필요한 것은 Facilitator가 아니라 「결제 전후의 관리・감사・제어」이다.

「브레이크」만으로는 부족했다

AI 에이전트가 자율적으로 JPYC로 지불하는 시대가 온다.

처음에는 「결제 전의 브레이크」가 필요하다고 생각했다. 하지만 잘 생각해보니 결제 후에도 문제가 있다.

일본의 인보이스 제도(Invoice System)다.

x402의 마이크로페이먼트(Micropayment)는 1회당 몇 엔에서 수백 엔이 중심이다. 이것을 전 건 인보이스 처리하는 것은 실무상 상당히 무겁다.

다만 일본의 인보이스 제도에는 「소액 특례」가 있다.

• 세금 포함 1만 엔 미만의 거래 → 장부 보존만으로 OK
• 대상: 과세 매출액 1억 엔 이하의 사업자
• 기간: 2023년 10월 ~ 2029년 9월까지

즉, x402의 마이크로페이먼트는 거의 전 건이 이 특례에 해당한다. 모든 tx(트랜잭션)에 청구서를 발행할 필요는 없다.

API의 가치가 한 단계 올라갔다

이 깨달음으로 agent-budget-guard의 설계가 바뀌었다.

AI 에이전트가 결제하기 전
↓
① 예산 체크・승인 필요 여부 판정 (기존)
...

「결제 전의 브레이크」에서 「결제 전후의 회계 정리」로 진화했다.

기업이 AI 에이전트 결제에서 정말로 곤란해하는 것은 결제 그 자체보다, 경비 처리가 가능한지・회계 소프트웨어에 넣을 수 있는지・감사 로그가 있는지이다.

Circle Arc라는 순풍

더 큰 움직임이 있다.

Circle이 Arc(stablecoin-native Layer 1)를 추진하고 있다.

Arc의 구성은 다음과 같다.

Arc = stablecoin-native L1 (금융 OS)

Gateway = unified USDC balance

Nanopayments = AI/API용 초소액 USDC 결제

x402 = HTTP 402 결제 표준

Circle은 이것들을 세트로 묶어 AI 에이전트 결제 인프라를 노리고 있다.

그리고 중요한 것은, Arc testnet에 JPYC Inc.가 이미 참여했다는 사실입니다.

JPYC는 USDC 경제권에 연결되는 방향으로 가고 있습니다. 즉, JPYC 기반의 관리 API는 Arc 시대에도 그대로 사용할 수 있습니다.

Circle이 '도로'를 만들수록, 제 API의 수요는 늘어납니다. 이것이 현재의 구도입니다.

앞으로의 전략

오늘 깨달은 점을 정리하면 다음과 같습니다.

• AI에게 선택받으려면, AI가 읽을 수 있는 Markdown을 배치한다
• JPYC x402 시장이 형성될수록, 결제 전후의 관리 API 수요가 늘어난다
• 일본의 인보이스 제도(Invoice System) 대응이 해외 세력과의 차별화 포인트가 된다
• Circle Arc / USDC / Gateway가 확산될수록, JPYC 일본 시장용 관리 API가 필요해진다
• 대기업이 시장을 만들기를 기다리면서, 보완적인 포지션으로서 실적을 쌓는다

'만드는' 페이즈(Phase)는 끝났습니다. 지금은 '기다리고, 지속하고, 축적하는' 페이즈입니다.

매일 지속하는 것이 최고의 전략이라고 생각합니다.

관련 링크:

• Agentic.Market: https://agentic.market
• Smithery: https://smithery.ai/servers/segawa4321/agent-memory-api
• GitHub: https://github.com/sasuke15134321
• Lost Fauna: https://lit.link/lostfauna

※ 본 기사의 인보이스 제도에 관한 기술은 정보 제공을 목적으로 합니다. 실제 세무 처리에 대해서는 세무사에게 확인하시기 바랍니다.

2026년 5월 시점의 정보를 바탕으로 작성되었습니다.

#llms #x402 #JPYC #AI에이전트 #AgentEconomy #개인개발 #API비즈니스 #인보이스