io.github.fatsearch/fats

Reads the pages your agent's built-in fetch can't (JS pages, PDFs) through your own provider key,
kept on disk as clean Markdown, navigated by outline and ids.

same question · same answer · 81× less context
That's the point.

Every page your agent reads costs you this

Your agent gets a short outline. It reads one section when it needs depth, not the whole page.
Menus, cookie banners, navigation, footer links, tracking scripts: gone.
Prices, dates, numbers: kept _{(loss guard counts every one)}.

[!TIP] The "free" fetch costs ~100× more at the model. And it stays in context, every turn after.

Your key never touches the chat

fats setup <provider> opens a one-time key form on 127.0.0.1, behind a random token, for 30 minutes.
You paste the key there in your browser, so it stays out of the chat, the model's context and the agent's logs.
The form refuses a POST from another origin; the key is checked live, saved with mode 0600, sent only to its provider.

$ fats setup decodo
= setup decodo · waiting for the key at http://127.0.0.1:59802/k/e0c8baba7a5b058947f4fdab97dabb05/decodo · 30 min · $0
tell the user (never ask for the key in chat):
1. open https://dashboard.decodo.com/web-data/playground  (no account yet: https://dashboard.decodo.com/register)
2. Copy the API key shown on the Web Data playground. Do NOT paste it in this chat.
3. open http://127.0.0.1:59802/k/e0c8baba7a5b058947f4fdab97dabb05/decodo , paste the key, press Save
then: fats setup   (when the user says done; end your turn, do not poll · checks it, $0)
link dead (30 min passed)? run fats setup decodo again and give the user the new line 3

fats setup shows a form still waiting (! form_waiting decodo · 23 min left · <its URL>) or one whose time ran out (! form_expired decodo · the link the user got is dead → fats setup decodo · new link, same 3 steps). Over SSH (SSH_CONNECTION or SSH_TTY set) one more line says how to paste the key in a terminal there.

On hard pages

fats tries plain HTTP first (free). If the page is a JS shell, a captcha, or a wall, it climbs to your providers: cheapest first, hedged, with cost tracking on every call.

$ fats https://www.nytimes.com/ dry:true
nytimes.com/ fetch plain → oxy (after a captcha) → bd ∥ oxyjs after 5s → new u1 · up to $0.0040

$ fats stats
u1 rust-lang.org · Rust Programming Language · plain 230ms $0.0000 · 1.2ktok
u2 en.wikipedia.org · Rust (programming language… · p

... [View full README on GitHub](https://github.com/fatsearch/fatsearch#readme)