English Français العربية

Trawlia

Registre officiel Recherche et web

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • TRAWLIA_API_KEY obligatoire 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que Trawlia ?

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

Comment installer Trawlia ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Trawlia ?

Oui. Il attend TRAWLIA_API_KEY, à renseigner dans sa configuration.

Trawlia est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Trawlia ?

Il est publié par ayhoung. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.