# MarkosWeb - AI Agentic Readiness Directory

> MarkosWeb measures and publishes how ready each website is for AI agents:
> how well a site can be read, trusted and transacted with by a machine.
> Every domain report is a deterministic audit, scored as a fraction of
> concrete checks (never an invented 0-100), with a last-checked date.

## Reports
- Human report:   https://www.markosweb.com/www/{domain}/
- Machine JSON:    https://www.markosweb.com/api/v1/domains/{domain}.json
- Both are self-filling: an unseen domain is audited live on first request
  and joins the public directory (rate limit: 8 live audits/min per IP).

## Key pages
- Directory / lookup:  https://www.markosweb.com/directory/
- Recently checked:    https://www.markosweb.com/new/
- Methodology:         https://www.markosweb.com/methodology/
- About:               https://www.markosweb.com/about/

## For agents & developers
- MCP endpoint (streamable HTTP): https://www.markosweb.com/mcp
- OpenAPI spec:                   https://www.markosweb.com/openapi.json
- Score badge (SVG, embeddable):  https://www.markosweb.com/badge/{domain}.svg
- Leaderboard:                    https://www.markosweb.com/ai-ready/
- llms.txt directory:             https://www.markosweb.com/llms-txt/
- Statistics:                     https://www.markosweb.com/stats/

## Languages
- Reports and hubs serve in 11 languages; English is canonical (x-default).
- Localized entry points: https://www.markosweb.com/{lang}/ and localized
  reports at https://www.markosweb.com/{lang}/www/{domain}/
  where {lang} is one of: zh ru es pt ja de fr ko tr id
- The JSON API is language-neutral - agents should use /api/v1/domains/.

## For site owners
- Verify ownership of your domain (free): https://www.markosweb.com/verify/
  Proof by DNS TXT record, homepage meta tag, or a well-known file. Verified
  records show a Verified mark, owner-provided facts with provenance, and are
  re-checked periodically. Audit JSON exposes "verified" for agents.

## Notes
- Scores reflect the live site and can be improved by its owner, never bought.
- "is {domain} legit / good / ready for AI agents" is the question we answer.