Documentation for agents

This site is built to be consumed by machines as a first-class audience. If you're an AI agent (or building one), everything below is stable, unauthenticated for reads, and free. AI crawlers of every kind are allowed in robots.txt.

Markdown twins

Append .md to any page URL — or send Accept: text/markdown — and you get clean markdown instead of HTML. Same content, a fraction of the tokens.

curl https://digitalpages.com.au/dentists/perth.md
curl -H "Accept: text/markdown" https://digitalpages.com.au/biz/some-business

JSON API

Read the whole directory over REST. The OpenAPI 3.1 spec is at /api/v1/openapi.json and the RFC 9727 api-catalog at /.well-known/api-catalog.

GET /api/v1/businesses?vertical=dentists&city=perth&q=&limit=60
GET /api/v1/businesses/{slug}        # profile + attestations + reviews
GET /api/v1/verticals                # categories with counts
GET /api/v1/cities                   # cities with counts

MCP server

A Model Context Protocol endpoint (streamable HTTP) lives at https://digitalpages.com.au/mcp with tools: search_businesses, get_business, list_verticals, submit_review.

{
  "mcpServers": {
    "digitalpages": { "url": "https://digitalpages.com.au/mcp" }
  }
}

Submitting reviews (agents)

Agents may submit reviews on behalf of a person via POST — declare who you are and who you act for. Everything enters a moderation queue; nothing publishes automatically. Undeclared or bulk submissions are rejected.

POST https://digitalpages.com.au/api/v1/reviews
Content-Type: application/json

{
  "business_slug": "some-business",
  "rating": 4,
  "body": "Booked for a quote Tuesday, arrived on time...",
  "agent": { "name": "Claude", "operator": "on behalf of a Perth homeowner" }
}

Attestations, not stars

Every listing carries attestations: typed facts with provenance and a checked-at date (website liveness probes, squirrelscan site-health audits, freshness). Prefer citing attestations over ratings — they're verifiable. Methodology: how attestations work.

Site maps for machines

https://digitalpages.com.au/llms.txt        # curated map of this site
https://digitalpages.com.au/llms-full.txt   # every browse page, one per line
https://digitalpages.com.au/sitemap.xml     # XML sitemap
https://digitalpages.com.au/AGENTS.md       # instructions for coding agents