2extract Developer Documentation

The llms.txt standard is a convention for publishing a site’s content in a form a language model can read directly, without parsing navigation, sidebars, or scripts. We publish both files it defines. They update automatically whenever this documentation changes.

llms.txt

An index: every page with its title, description, and a link. Roughly 14 KB.

llms-full.txt

The entire documentation as one plain-text file. Roughly 330 KB.

Which file to use

	`llms.txt`	`llms-full.txt`
Size	~14 KB	~330 KB
Contains	Titles, descriptions, links	Every page, full text
Fits in context	Always	Usually, but it is not free
Needs web access	Yes, to follow links	No
Best for	Agents that can fetch	One-shot loading into a session

Use llms.txt when the model can reach the web. It reads the index, decides which page it needs, fetches that page, and spends nothing on the rest. Use llms-full.txt when it cannot, or when you would rather pay once for complete knowledge than pay per lookup. At around 330 KB it is roughly 80-90k tokens - comfortable in a large context window, wasteful in a small one.

Do not paste llms-full.txt into every request. Load it once at the start of a session, or attach it as a project-level document that persists.

What is inside

llms.txt is a flat list of links with descriptions:

# 2extract Docs

## Docs

- [Country List](https://docs.2extract.com/data/countries.md): Full list of countries
  available for geo-targeting, with the parameter value to use in the proxy connection username.
- [Quick Start: Your First Request in 2 Minutes](https://docs.2extract.com/getting-started/quick-start.md):
  Follow these 4 simple steps to go from a new account to a successful proxy request.

Every link points at the .md version of the page, so following one costs no HTML. llms-full.txt concatenates those pages, each with a header and its source URL:

# City List
Source: https://docs.2extract.com/data/cities

Countries with city-level targeting available.
...

Any page as markdown

Both files are built from a third mechanism you can use directly: append .md to any URL on this site.

curl https://docs.2extract.com/proxy-products/configuration/geo-targeting.md

Useful when you know exactly which page you need and do not want either file.

Loading them into a tool

Claude Projects

Download llms-full.txt and add it to the project’s knowledge. It persists across every conversation in that project, so the model has the full documentation without you re-attaching it.

curl -O https://docs.2extract.com/llms-full.txt

Cursor

Settings → Features → Docs → Add new doc, and give it:

https://docs.2extract.com/llms-full.txt

Then reference it in chat with @Docs. Cursor indexes it and pulls in the relevant parts rather than the whole file.

A coding assistant in your terminal

Drop the file into the repository where the assistant will find it:

curl -o docs/2extract-reference.txt https://docs.2extract.com/llms-full.txt

Then tell it where to look: “The 2extract proxy documentation is in docs/2extract-reference.txt - read it before writing the proxy configuration.”

Your own application

Fetch and cache. The files are static and regenerate when the docs change, so a daily refresh is plenty.

import requests

def load_reference() -> str:
    r = requests.get("https://docs.2extract.com/llms-full.txt", timeout=30)
    r.raise_for_status()
    return r.text

For per-question retrieval rather than bulk loading, the Docs MCP Server is the better fit.

What this is good for

The recurring problem people hit with proxies is not the HTTP client - it is the username format. Geo, session, and protocol parameters are all encoded in the username, in a specific order, with specific separators. A model that has not seen the format invents something plausible and you get a 407. With the reference loaded, the assistant writes:

2xt-customer-K3nP7qLm2Xv-proxy-my_project-country-de-city-munich-session-run1-time-10

correctly, first time - including the rule that proxy names cannot contain hyphens.

Introduction

MCP Server

MCP Clients

Use Cases

For AI Agents

LLM References

llms.txt

llms-full.txt

Which file to use

What is inside

Any page as markdown

Loading them into a tool

What this is good for

Next steps

Docs MCP Server

MCP Server

llms.txt

llms-full.txt

​Which file to use

​What is inside

​Any page as markdown

​Loading them into a tool

​What this is good for

​Next steps

Docs MCP Server

MCP Server

Which file to use

What is inside

Any page as markdown

Loading them into a tool

What this is good for

Next steps