English Français العربية

Trawlia

Official registry Search and web

Web search and page extraction for agents, returned as readable text rather than raw JSON.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package trawlia-mcp
Claude Code 
claude mcp add trawlia -e 'TRAWLIA_API_KEY=<your trawlia_api_key>' -e 'TRAWLIA_BASE_URL=<TRAWLIA_BASE_URL>' -- npx -y trawlia-mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "trawlia": {
            "command": "npx",
            "args": [
                "-y",
                "trawlia-mcp@0.1.0"
            ],
            "env": {
                "TRAWLIA_API_KEY": "<your trawlia_api_key>",
                "TRAWLIA_BASE_URL": "<TRAWLIA_BASE_URL>"
            }
        }
    }
}

Environment variables

  • TRAWLIA_API_KEY required secret A Trawlia API key. Free at https://trawlia.co/signup, 100 credits a month, no card.
  • TRAWLIA_BASE_URL Override the API origin. Defaults to https://api.trawlia.co; only needed to point at a local server.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. trawlia-mcp
  2. Claude Code
  3. Claude Desktop, Cursor, and anything else reading a JSON config
  4. The tools
  5. What the model sees
  6. Costs
  7. Not available
  8. Checking it works
  9. Environment

trawlia-mcp

Trawlia as an MCP server: news search, web search and page extraction, as two tools any MCP client can call.

Get a free key at trawlia.co/signup - 1,000 credits a month, no card.

Claude Code

claude mcp add trawlia --env TRAWLIA_API_KEY=twl_... -- npx -y trawlia-mcp

Claude Desktop, Cursor, and anything else reading a JSON config

{
  "mcpServers": {
    "trawlia": {
      "command": "npx",
      "args": ["-y", "trawlia-mcp"],
      "env": { "TRAWLIA_API_KEY": "twl_..." }
    }
  }
}

The tools

Ranked, deduplicated results from the live web.

ArgumentDefaultNotes
queryrequiredNatural language, not keywords.
search_depthbasicbasic is 1 credit and returns snippets. advanced is 2 and returns full page text.
topicgeneralnews reaches news indexes and returns publication dates.
max_resultsallTop N of the ranked list. Left out, every result found is returned, typically 20 to 60. These go into your context, so set it when the task is narrow.
include_domains / exclude_domains-Host filters. Subdomains are included.
time_range-day, week, month, year.
trawlia_extract

Fetches URLs you already have and returns their readable content, with navigation, cookie banners and newsletter modals removed. 1 credit per 5 URLs, so pass the whole list at once.

What the model sees

Results come back as readable text rather than raw JSON, and carry two things a plain response would lose:

  • When a page could not be read, the result says so and why, instead of presenting a snippet as though it were the article.
  • A coverage line when a source was unavailable, so the model can weigh a thin result set properly rather than reporting it as a confident nothing.

Errors are readable sentences that say whether retrying is worth it. Running out of credits says so and says not to retry; a rate limit says how long to wait.

Costs

OperationCredits
Basic search1
Advanced search2
Extraction1 per 5 URLs

Charged before the work and refunded on hard failure. Full price list at trawlia.co/pricing.

Not available

Search and extraction, and nothing else. There is no crawler and no long-running job to poll. If your agent needs to walk a whole site, this is the wrong server for it.

Checking it works

TRAWLIA_API_KEY=twl_... node smoke.mjs

Spends a few credits against the real API and prints what a client sees: the tool list, a rendered search, a rejected parameter, and an extraction. Not in CI, because it costs money and depends on the live web.

Environment

VariableRequiredNotes
TRAWLIA_API_KEYyesA search-scoped key is enough and is what you should deploy.
TRAWLIA_BASE_URLnoDefaults to https://api.trawlia.co. For pointing at a local server.

Frequently asked questions

What is Trawlia?

Web search and page extraction for agents, returned as readable text rather than raw JSON.

How do I install Trawlia?

It runs on your machine. In Claude Code: claude mcp add trawlia -e 'TRAWLIA_API_KEY=<your trawlia_api_key>' -e 'TRAWLIA_BASE_URL=<TRAWLIA_BASE_URL>' -- npx -y trawlia-mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Trawlia need an API key?

Yes. It expects TRAWLIA_API_KEY, which you set in its configuration.

Is Trawlia open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Trawlia?

It is published by ayhoung. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.