# URL to Markdown

URL to Markdown web reader for agents and RAG: the title, author and main article text of a page, with robots.txt honoured.

Send a URL and get the title, author and main text as Markdown, ready for an LLM. No browser is run, so pages that need JavaScript or a login are refused rather than returned empty, and you are not charged. We honour robots.txt and text-and-data-mining opt-outs.

- Stays inside site rules: robots.txt and text-and-data-mining opt-outs are honoured, where others sell bypass.
- A page that needs JavaScript or a login is refused rather than returned empty, and not charged.
- An article extractor that returns title, author and main text as clean Markdown, ready for a language model.

## Calls

### `POST https://readymadeapi.com/v1/web-reader`

Fetch one public page and return its title and main content as Markdown.

- Price: $0.00064 per page
- MCP tool: `web_reader_read`
- Answers in the same call.

Request:

```json
{
  "url": "https://readymadeapi.com/samples/article.html"
}
```

Answer:

```json
{
  "byline": "Ana Example",
  "markdown": "By Ana Example\n\nA sourdough starter is flour and water in which wild yeast has settled. It is hard to kill and easy to neglect. This sample article exists so that the examples in our API listings have a real page to read.\n\n## The weekly routine\n\n1.  Keep the jar in the fridge between bakes.\n2.  Once a week, discard all but two spoonfuls.\n3.  Feed it equal weights of flour and water, and leave it out for four hours.\n\n## When you forget\n\nA grey liquid on top is alcohol, not mould. Pour it off, feed the starter twice a day for three days, and it will rise again. Pink or orange streaks are a different matter: throw it away and start over.\n\nThe rule that matters is the simplest one: **feed it before you need it**, not when you remember it.",
  "title": "How to keep sourdough starter alive",
  "url": "https://readymadeapi.com/samples/article.html",
  "words": 144
}
```

## Limits

- One public page per call; pages that need JavaScript or a login are refused.

## Questions

**Why was my URL refused?**

The site forbids automated reading of that page, or it needs JavaScript or a login. You are not charged.

**Does it run a browser?**

No, which keeps it fast and predictable.

**Why did I get a 429 site_busy?**

We ask each site slowly, across all our users. When a site has been asked too often you get an uncharged 429 with a Retry-After.

## Using it

- Send `Authorization: Bearer <key>` and a JSON body. Keys and credit: https://readymadeapi.com/account
- Every answer carries `X-Request-Id`, `X-Units` and `X-Charged-Usd`.
- An error is a JSON problem with a `title` to act on and a `detail` in plain words; nothing is charged for it.
- Full schema: https://readymadeapi.com/openapi.json
