mcpField
T
Trawlia

Trawlia

本地服务
trawlia.co搜索与检索01 周前更新
代码仓库访问官网

关于 Trawlia

Trawlia 是面向需要实时网页或新闻搜索及可读页面提取的 Agent 的 MCP 服务。它通过两个工具返回排序后的搜索结果和清理后的页面文本。

主要功能

  1. 01搜索实时网页
  2. 02搜索带发布日期的新闻
  3. 03按域名和时间筛选结果
  4. 04提取可读页面内容
  5. 05说明来源覆盖情况与读取失败

适用场景

  1. 01查找某主题的最新信息
  2. 02按时间范围搜索新闻
  3. 03提取一组 URL 的页面文本

MCP 相关

它向 MCP 客户端提供 `trawlia_search` 和 `trawlia_extract` 工具。使用时需要 Trawlia API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "co-trawlia-trawlia": {
      "command": "npx",
      "args": [
        "-y",
        "trawlia-mcp"
      ],
      "env": {
        "TRAWLIA_API_KEY": "<TRAWLIA_API_KEY>",
        "TRAWLIA_BASE_URL": "<TRAWLIA_BASE_URL>"
      }
    }
  }
}
启动命令npx -y trawlia-mcp
需要配置的环境变量
TRAWLIA_API_KEY密钥A Trawlia API key. Free at https://trawlia.co/signup, 100 credits a month, no card.
TRAWLIA_BASE_URLOverride the API origin. Defaults to https://api.trawlia.co; only needed to point at a local server.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmtrawlia-mcp0.1.0

工具

2

收录的工具列表 · 更新于 2 周前

参数类型必填说明
querystring是用自然语言而非关键词提出的问题。
topicenum否'news' 表示近期事件；会返回发布日期，而 'general' 通常不会。general | news
time_rangeenum否从现在起向前回溯的时间范围。会丢弃没有发布日期的结果，因此在 topic 为 'general' 时筛选会很严格。day | week | month | year
max_resultsinteger否结果通常越少越好；这些结果会纳入你的上下文。
search_depthenum否'basic' 消耗 1 个积分并返回摘要。'advanced' 消耗 2 个积分并返回完整页面文本。优先使用 basic。basic | advanced
exclude_domainsarray否
include_domainsarray否将搜索结果限制为这些主机。也包括子域名。

详细介绍

trawlia-mcp

将 Trawlia 用作 MCP 服务：新闻搜索、网页搜索和页面提取，作为两个工具供任何 MCP 客户端调用。

在 trawlia.co/signup 免费获取密钥——每月 1,000 个积分，无需银行卡。

Claude Code

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

Claude Desktop、Cursor 及其他读取 JSON 配置的客户端

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

工具

trawlia_search

从实时网络中获取经过排序和去重的结果。

参数默认值说明
query必填使用自然语言，而非关键词。
search_depthbasicbasic 消耗 1 个积分并返回摘要。advanced 消耗 2 个积分并返回完整页面文本。
topicgeneralnews 会搜索新闻索引并返回发布日期。
max_results全部排序列表中的前 N 条结果。省略时会返回找到的所有结果，通常为 20 到 60 条。这些内容会进入你的上下文，因此任务范围较窄时请设置此参数。
include_domains / exclude_domains-主机筛选条件。包含子域名。
time_range-day、week、month、year。
trawlia_extract

抓取你已有的 URL，并返回可读内容，同时移除导航、Cookie 横幅和新闻简报弹窗。 每 5 个 URL 消耗 1 个积分，因此请一次性传入整个列表。

模型看到的内容

结果以可读文本而非原始 JSON 的形式返回，并包含两项普通响应会遗漏的信息：

  • 页面无法读取时，结果会说明这一点及其原因，而不是把摘要呈现得像文章正文一样。
  • 来源不可用时，会提供覆盖情况说明，让模型能正确评估结果不足的情况，而不是将其报告为确定无结果。

错误会以可读句子的形式说明是否值得重试。积分用尽时会说明情况并提示不要重试；达到速率限制时会告知需要等待多久。

费用

操作积分
基础搜索1
高级搜索2
提取每 5 个 URL 消耗 1 个积分

处理前扣除费用，遇到硬性失败时退款。 完整价格列表请见 trawlia.co/pricing。

不提供的功能

仅提供搜索和提取，没有其他功能。没有爬虫，也没有可轮询的长时间运行任务。如果你的 Agent 需要遍历整个网站，这就不是适合它的服务。

检查是否正常运行

TRAWLIA_API_KEY=twl_... node smoke.mjs

会通过真实 API 消耗少量积分，并打印客户端所见内容：工具列表、渲染后的搜索结果、被拒绝的参数，以及一次提取。 不会在 CI 中运行，因为这会产生费用，且依赖实时网络。

环境变量

变量必填说明
TRAWLIA_API_KEY是具有 search 权限范围的密钥就足够了，也是建议部署使用的密钥。
TRAWLIA_BASE_URL否默认为 https://api.trawlia.co。用于指向本地服务。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。