Researchsearch

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Oct 31, 2026

Web search, page extraction, crawling, and site mapping powered by the Tavily API.

已驗證STDIO僅桌面網頁搜尋與抓取知識與記憶

概覽

AI 產生的概覽

以 Tavily 為後端的研究伺服器，讓助理搜尋網頁、擷取頁面正文、爬取網站並整理其 URL 結構。

可以做什麼
  • 搜尋網頁，回傳具排序與內容摘錄的結果，可選擇附上生成式答案與原始頁面內容
  • 從指定的一個或多個頁面擷取乾淨正文，失敗項目另行回報
  • 從起始網址爬取網站，可限制深度、廣度與頁數，回傳每個造訪頁面的內容
  • 整理網站結構，只回傳可達的 URL，不含頁面內容
適用情境
適合助理需要最新網路資訊、乾淨的網頁正文，或在閱讀前先掌握網站有哪些頁面的情境。每個工具對應一次 Tavily 介面呼叫，較適合研究與內容蒐集，而非本機檔案處理。
執行需求
以本機 stdio 程序執行，可透過 npx 或 Docker 映像啟動。必須提供 Tavily API 金鑰，放在 TAVILY_API_KEY 環境變數中；缺少時所有操作會在送出請求前就報錯。需要能連線至 Tavily API 的網路。
安裝前請注意
TAVILY_API_KEY 是憑證，請勿寫入共用設定。查詢內容、網址與爬取的頁面會傳送給第三方 Tavily 服務，用量可能依你的 Tavily 方案計費。爬取與整理可能抓取大量頁面，請以深度與數量限制控制成本與負載。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Researchsearch，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

researchsearch

researchsearch is a research desk for the web, powered by the Tavily API. It searches with ranked, content-bearing results (and an optional generated answer), pulls the clean text out of specific pages, crawls a site page by page under limits you set, and maps a site's structure so you can see what is there before you read it. It works from the command line or as an MCP server for agents.

A Tavily API key is required. Put it in the TAVILY_API_KEY environment variable; without it, every operation stops with an error that names the missing variable, before any request is made.

Install

bash
export TAVILY_API_KEY="tvly-..."npx @reneturcios/researchsearch search "composting basics"

Or run the container image:

bash
docker run -i -e TAVILY_API_KEY="tvly-..." ghcr.io/cloudcorprecords/researchsearch

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

bash
# Search; results print as JSONresearchsearch search "composting basics"researchsearch search "rate decision" --topic news --days 3 --max-results 5 --answer
# Extract the clean content of one or more pagesresearchsearch extract https://example.com/articleresearchsearch extract https://example.com/a https://example.com/b --depth advanced
# Crawl a site from a starting pageresearchsearch crawl https://example.com --max-depth 2 --limit 25researchsearch crawl https://example.com --instructions "Focus on the guides"
# Map a site's structure (URLs only, no page content)researchsearch map https://example.com --max-depth 1 --limit 50
researchsearch --version

Exit codes: 0 on success, 1 when an operation fails (a missing TAVILY_API_KEY, an HTTP error from the service, an unreachable host), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

bash
npx -y @reneturcios/researchsearch mcp

MCP client configuration:

json
{  "mcpServers": {    "researchsearch": {      "command": "npx",      "args": ["-y", "@reneturcios/researchsearch", "mcp"],      "env": {        "TAVILY_API_KEY": "tvly-..."      }    }  }}

Tools

ToolInputWhat it returns
tavily-searchquery (string, required), search_depth, topic, days, max_results, include_answer, include_raw_content, include_domains, exclude_domains (all optional)Ranked results with content excerpts and scores, plus a generated answer and raw page content when requested.
tavily-extracturls (string array, required), extract_depth, include_images, query (optional)The clean extracted content of each page, with failures reported separately.
tavily-crawlurl (string, required), max_depth, max_breadth, limit, instructions, extract_depth (optional)The pages visited from the starting URL, each with its extracted content.
tavily-mapurl (string, required), max_depth, max_breadth, limit, instructions (optional)The list of URLs reachable from the starting page, without page content.

Each tool is one call to the matching Tavily API endpoint. Only the parameters you set are sent — unset optionals are omitted so the service applies its own defaults — and each response is the service's JSON, passed back unchanged.

Development

bash
npm installnpm run build   # tsc -> dist/npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)npm run dev     # run the CLI from source via tsx

License

MIT — see LICENSE.

來源：README.md，提交 c9edaa2

工具

4

tavily-extract

Extract clean content from one or more web pages with Tavily.

輸入參數urls必填queryextract_depthinclude_images

tavily-crawl

Crawl a website from a starting URL with Tavily, extracting content from the pages it visits.

輸入參數url必填limitmax_depthmax_breadthinstructionsextract_depth

tavily-map

Map a website's structure with Tavily, returning the URLs reachable from a starting page.

輸入參數url必填limitmax_depthmax_breadthinstructions

版本歷史

1
  1. v0.1.0最新Oct 31, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分