GitHub
                                  $$\             $$\                                   
                                  $$ |            $$ |                                  
$$$$$$\$$$$\   $$$$$$\   $$$$$$\  $$ |  $$\  $$$$$$$ | $$$$$$\  $$\  $$\  $$\ $$$$$$$\  
$$  _$$  _$$\  \____$$\ $$  __$$\ $$ | $$  |$$  __$$ |$$  __$$\ $$ | $$ | $$ |$$  __$$\ 
$$ / $$ / $$ | $$$$$$$ |$$ |  \__|$$$$$$  / $$ /  $$ |$$ /  $$ |$$ | $$ | $$ |$$ |  $$ |
$$ | $$ | $$ |$$  __$$ |$$ |      $$  _$$<  $$ |  $$ |$$ |  $$ |$$ | $$ | $$ |$$ |  $$ |
$$ | $$ | $$ |\$$$$$$$ |$$ |      $$ | \$$\ \$$$$$$$ |\$$$$$$  |\$$$$$\$$$$  |$$ |  $$ |
\__| \__| \__| \_______|\__|      \__|  \__| \_______| \______/  \_____\____/ \__|  \__|
for agents
v0.1.0API Reference
Endpoints
GET/r?url={url}

Returns clean Markdown with YAML frontmatter — title, type, token count — so agents parse metadata and content from a single response.

bash
$ curl "https://md.pcar.me/r?url=example.com"
response · text/markdown
---
url: https://example.com
title: "Example Domain"
type: unknown
tokens: 42
---

# Example Domain

This domain is for use in illustrative examples...

## Actions

[1] link: Learn more (click)
GET/map?url={url}

Returns a structured PageMap JSON — interactables (buttons, forms, CTAs), metadata, images, stats. Useful when your agent needs to know what it can do, not just read.

bash
$ curl "https://md.pcar.me/map?url=example.com"
response · application/json
{
  "url":          "https://example.com",
  "title":        "Example Domain",
  "page_type":    "unknown",
  "interactables": [
    { "ref": 1, "role": "link", "name": "Learn more", "affordance": "click" }
  ],
  "stats": { "tokenCount": 42, "conversionStrategy": "ai-tomarkdown" }
}
Response Headers

Both endpoints return these diagnostic headers.

  • X-Token-Count42

    Estimated token count of the response body

  • X-Page-Typearticle

    Detected page category (article, product, search, listing, unknown)

  • X-Conversion-Strategyai-tomarkdown

    Which conversion tier was used

  • X-Source-Formattext/html

    Original content-type of the upstream response

  • X-Generation-Ms3.2

    Enrichment processing time in milliseconds

Supported Formats

Any URL pointing to these content types.

  • .htmlWeb pages
  • .pdfPDF documents
  • .docxWord documents
  • .xlsxExcel spreadsheets
  • .pptxPowerPoint files
  • .csvCSV data
  • .txtPlain text (passthrough)
  • .mdMarkdown (passthrough)
Error Codes

Standard HTTP status codes.

  • 400Missing url parameter
  • 403SSRF blocked — private IP, localhost, or unsafe scheme
  • 413Upstream response exceeds 2 MB
  • 415Unsupported content type (e.g. video/mp4)
  • 429Target site returned 429 (Too Many Requests)
  • 502Upstream returned an error
10sFetch timeout
2 MBMax response size
No authRequired
MarkdownForAgents © 2026