# Building an Agent-Readable Site: HTML, Markdown and .data.json

> AgentFlare serves every article at one path as HTML, a free .md teaser, and a metered .data.json or .full.md. A shared JSON envelope lets agents parse any…

- **Canonical:** https://agentflare.org/guides/building-an-agent-readable-site-html-markdown-and-datajson.html
- **Updated:** 2026-10-15
- **Category:** guides

## Key data

- **Track:** For publishers
- **Level:** Intermediate
- **Access:** Free / open
- **Updated:** 2026-10-15

AgentFlare serves every article at one path as HTML, a free .md teaser, and a metered .data.json or .full.md. A shared JSON envelope lets agents parse any section with the same code.

## Sources

1. [Header name: X-Crawler-Token](https://esa.aisa.one/cdn/open-verify.html)
2. [AgentFlare llms.txt (header and structure)](https://agentflare.org/llms.txt)
3. [AgentFlare pricing.json (directory price map)](https://agentflare.org/pricing.json)
4. [AgentFlare Newswire .data.json field reference](https://agentflare.org/news/index.html)
5. [AgentFlare Markets .data.json field reference](https://agentflare.org/markets/index.html)
6. [AgentFlare robots.txt](https://agentflare.org/robots.txt)

## Related

- [Pricing Content by Directory: Best Practices](https://agentflare.org/guides/pricing-content-by-directory-best-practices.html)
- [robots.txt, llms.txt & Sitemaps for AI Crawlers](https://agentflare.org/guides/robotstxt-llmstxt-sitemaps-for-ai-crawlers.html)
- [How the Edge Verify API Decides Access](https://agentflare.org/guides/how-the-edge-verify-api-decides-access.html)
- [Getting Started with HTTP 402 Pay-Per-Crawl](https://agentflare.org/guides/getting-started-with-http-402-pay-per-crawl.html)
- [Crawler Tokens & Auto-Pay: A How-To](https://agentflare.org/guides/crawler-tokens-auto-pay-a-how-to.html)
- [Handling 402 and 403 Responses: An Error Reference for Agents](https://agentflare.org/guides/handling-402-and-403-responses-an-error-reference-for-agents.html)

---
_Part of AgentFlare, an agent-native data network powered by AISA. https://aisa.one/docs_