Communitygithub.com

specstream/specstream-tools

即時網路資料引擎。搜尋 API:全世界最準確的網路搜尋 API,每 1,000 次搜尋只需 $5 (specstream.ai/benchmarks)。擷取 API:每 1,000 頁 $0.80。深度搜尋:結構化資料列。

specstream-tools 是什麼?

SpecStream 是一個即時網路資料引擎,專為團隊和 AI 代理器設計。它提供統一的平台,用於建構、搜尋、擷取、豐富化、對應及監控整個網路上的資料。使用者可以用自然語言提出任何資料集需求,SpecStream 就會從整個即時網路中找出所有匹配項目,將其擷取並豐富化為結構化記錄,並監控後續的變更。此工具支援多種平台,包括 API、MCP、Claude Code、Cursor、ChatGPT、Codex 等,並且可以整合到 Sheets、CRM、Slack、n8n 和 Zapier 等常見工具中。SpecStream 的核心產品包括搜尋 API (F 分數達 97.9 的準確網路搜尋)、擷取 API (從網頁、PDF、Word 或 Excel 檔案中擷取文字),以及深度搜尋 (以結構化資料列形式提供所有匹配結果)。它提供多種語言的 SDK,包括 Python、TypeScript 等,並與業界標準的搜尋 API (如 Tavily、Exa、Brave、Serper 等) 完全相容,可作為無痛替代方案。使用者可以設定消費上限,並以透明且可預測的按用量計費。

相容平台✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓OpenCode✓Windsurf
npx skills add https://github.com/specstream/specstream-tools/tree/main

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

預覽

來自技能 README

一個請求、其價格以及包含來源的資料列
PyPI
npm
n8n node
MCP Registry
Add to Replit
specstream-tools preview

說明文件

一個平台,即可在整個網路上建構、搜尋、擷取、豐富化、對應及監控資料。

用簡單的文字提出任何資料集需求,SpecStream 就會從整個即時網路中為您建構:找出所有匹配項目,將其擷取並豐富化為結構化記錄,然後監控後續變更。它可透過 API 和 MCP 執行,並可整合到 Sheets、CRM、Slack、n8n、Zapier 以及團隊已在使用其他工具中。

產品功能價格
搜尋 APIGET /v1/web-search。全世界最準確的網路搜尋 API:在全部 1,000 題 SimpleQA Verified 問題上達到 97.9 F-score,在全部 200 題 WideSearch 任務上達到 64.0 item F1(分數與方法)。可在數秒內回答即時網路上的問題。每 1,000 次搜尋 $5,使用 speed=fast 則每 1,000 次 $1
擷取 APIPOST /v1/extract。每次呼叫可擷取最多 20 個網頁、PDF、Word 或 Excel 檔案的主要文字。MCP 工具為 read_pages。每 1,000 頁 $0.80。無文字的頁面不收費。
深度搜尋用簡單文字提問。取得即時網路上的所有匹配項目,並以結構化資料列呈現。也可豐富化您現有的清單,並監控變更。每列 5 美分、15 美分或 $1

搜尋:

curl -G https://api.specstream.ai/v1/web-search \
  -H "Authorization: Bearer $SPECSTREAM_API_KEY" \
  --data-urlencode "q=What is the population of Japan?"

擷取:

curl https://api.specstream.ai/v1/extract \
  -H "Authorization: Bearer $SPECSTREAM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com"]}'

使用 Python 的搜尋 API:在數秒內回答即時網路上的問題。

# pip install specstream-client
import os
from specstream_client import Client

client = Client(os.environ["SPECSTREAM_API_KEY"])

search = client.web_search(q="What is the population of Japan?")
for source in search["sources"][:1]:
    print(source["title"], source["url"], source["snippet"])

使用 Python 的擷取 API:每次呼叫可擷取最多 20 個網頁、PDF、Word 或 Excel 檔案的主要文字。

# pip install specstream-client
import os
from specstream_client import Client

client = Client(os.environ["SPECSTREAM_API_KEY"])

extract = client.extract_pages({"urls": ["https://example.com"]})
for page in extract["results"][:1]:
    print(page["title"], page["url"], page["text"])

使用 TypeScript 的搜尋 API:

// npm install @specstream/sdk
import { Client } from "@specstream/sdk";

const client = new Client({ apiKey: process.env.SPECSTREAM_API_KEY! });

const search = await client.webSearch({ q: "What is the population of Japan?" });
for (const source of search.sources.slice(0, 1)) {
  console.log(source.title, source.url, source.snippet);
}

使用 TypeScript 的擷取 API:

// npm install @specstream/sdk
import { Client } from "@specstream/sdk";

const client = new Client({ apiKey: process.env.SPECSTREAM_API_KEY! });

const extract = await client.extractPages({ urls: ["https://example.com"] });
for (const page of extract.results.slice(0, 1)) {
  console.log(page.title, page.url, page.text);
}
  • 每個數值都附帶來源 URL 和閱讀時間。
  • 搜尋 API 和擷取 API 無需報價和核准。每次搜尋或每個頁面會從您的餘額中扣除固定的費用。
  • 在深度搜尋中,每次執行的最高費用會在執行前顯示並獲得核准。只有已交付的資料列才會計費,若執行未找到任何結果則不收取費用。
  • 已儲存的請求會每小時到每年重新執行一次,每個資料列都會被標記為已變更、未變更或不再匹配。
  • 您的代理器在您帳號下運作,並遵守您設定的消費上限。

可無痛取代您正在使用的 API

SpecStream 可以接受為這些搜尋 API 編寫的呼叫,使用自己的地址,並以各 API 自己的回覆格式回應。若要切換,只需更改基礎地址和金鑰即可。每次搜尋呼叫都會在您的 SpecStream 金鑰上執行一次搜尋 API 網路搜尋。無痛轉換的呼叫會執行快速搜尋:最多 10 個結果 $0.001(每 1,000 次搜尋 $1),同一次呼叫中每增加 10 個結果加收 $0.0012。要求答案或使用 API 詳盡模式的呼叫會執行預設搜尋:最多 10 個結果 $0.005,每增加 10 個結果 $0.006。

您呼叫的 API您目前的基礎地址SpecStream 地址SpecStream 金鑰放置位置
Tavilyhttps://api.tavily.comhttps://api.specstream.ai/tavilyBearer token 或 api_key
Exahttps://api.exa.aihttps://api.specstream.ai/exax-api-key 或 Bearer token
Brave Search APIhttps://api.search.brave.comhttps://api.specstream.aiX-Subscription-Token
Serperhttps://google.serper.devhttps://api.specstream.ai/serperX-API-KEY
Bing Web Search API v7https://api.bing.microsoft.com/v7.0/searchhttps://api.specstream.ai/v7.0/searchOcp-Apim-Subscription-Key
Google Custom Search JSON APIhttps://www.googleapis.com 或 https://customsearch.googleapis.comhttps://api.specstream.aikey=(cx 會接受但不會使用)
SearXNG (JSON)您的實例地址https://api.specstream.ai/searxng/<key>在地址中、key=、X-API-Key 或 Bearer token
Firecrawl v2https://api.firecrawl.devhttps://api.specstream.ai/firecrawl(JavaScript SDK 和應用程式)或 https://api.specstream.ai(Python SDK)Bearer token

官方的 Tavily 和 Exa Python SDK 接受地址作為引數:

import os
from tavily import TavilyClient
from exa_py import Exa

tavily = TavilyClient(api_key=os.environ["SPECSTREAM_API_KEY"], api_base_url="https://api.specstream.ai/tavily")
exa = Exa(api_key=os.environ["SPECSTREAM_API_KEY"], base_url="https://api.specstream.ai/exa")
  • 未指定結果數量的呼叫會回傳 10 個結果,快速搜尋費用為 $0.001。Brave 的預設值是 20:發送 count=20 可取得 20 個結果,費用為 $0.0022。
  • Firecrawl /v2/scrape 呼叫相當於一次擷取 API 頁面,費用為 $0.0008。Firecrawl JavaScript SDK 可與此地址搭配使用。Firecrawl Python SDK 接受主機根目錄:Firecrawl(api_key=..., api_url="https://api.specstream.ai")。
  • 每個路由的請求和回覆欄位請參閱:specstream.ai/agents.md。請在 specstream.ai/workspace 的代理器與 API 下建立金鑰。新帳戶可獲得 $10 的免費額度,無需信用卡。

一個請求、其價格以及包含來源的資料列

PyPI npm n8n node MCP Registry Add to Replit

此儲存庫包含您安裝 SpecStream 時所需的項目:MCP 客戶端設定、代理器外掛和技能、SDK、n8n 節點、GitHub Action 以及範例。產品本身在 specstream.ai 上執行。使用 MIT 許可證。

路徑說明
server.json官方 MCP 註冊表的條目 ai.specstream/specstream
skills/代理器技能:search-web, extract-pages, compile, review-work, approve-work, continue-work
plugins/claude-code/Claude Code 外掛(MCP 伺服器和六個技能)
plugins/github-agent/給讀取 agent-plugins 格式的代理器使用的外掛
.cursor-plugin/Cursor 外掛
packages/sdk-py/specstream-client:Python 客戶端與 specstream 指令
packages/sdk-ts/@specstream/sdk:TypeScript 客戶端
packages/langchain-specstream/langchain-specstream:LangChain 工具和一個檢索器
packages/llama-index-tools-specstream/llama-index-tools-specstream:LlamaIndex 工具規格和一個檢索器
packages/crewai-specstream/crewai-specstream:CrewAI 工具
packages/specstream-haystack/specstream-haystack:Haystack 列表擷取器元件和代理器工具
packages/ai-sdk/@specstream/ai-sdk:Vercel AI SDK 工具
packages/mcp-stdio/specstream-mcp-stdio:為僅啟動本機伺服器的客戶端提供的 stdio 代理
integrations/n8n/n8n-nodes-specstream:n8n 社群節點
integrations/opencode/opencode-specstream:OpenCode 外掛(MCP 伺服器和四個技能)
integrations/openclaw/@specstream/openclaw-plugin:OpenClaw 外掛(尋找列表、讀取其資料列、四個技能)
integrations/pi/@specstream/pi-package:Pi 套件(託管的 MCP 伺服器和四個技能)
integrations/obsidian/Obsidian 外掛:在筆記中請求資料、核准價格、取得包含每個數值來源的 Markdown 表格
integrations/open-webui/Open WebUI 工具:從聊天中報價、核准和讀取結果,以及原生 MCP 路由
integrations/anythingllm/AnythingLLM 代理器技能,以及 MCP 路由
integrations/convex/Convex 元件(@specstream/convex):將即時網路資料作為記錄存入您的 Convex 表格,每個數值都有來源
integrations/fivetran/Fivetran Connector SDK 連接器:將您的列表、記錄以及每個數值及其來源頁面存入您的資料倉儲
integrations/airbyte/Airbyte 來源(僅限 manifest):您的列表和記錄,每個數值帶有來源頁面
integrations/meltano/PyPI 上的 tap-specstream:供 Meltano 和任何 Singer 目標使用的 Singer tap,列表和記錄,每個數值帶有來源頁面
integrations/coda/Coda Pack:將列表同步到表格中,每個數值帶有來源欄位、報價請求、從按鈕尋找列表
plugins/grok/Grok Build 外掛(託管的 MCP 伺服器和四個技能)
plugins/kiro/Kiro power(託管的 MCP 伺服器和四個技能)
integrations/vscode/VS Code 擴充功能:MCP 登入和 @specstream 聊天
actions/find-action/執行請求並上傳 CSV 的 GitHub Action
Formula/命令列工具的 Homebrew formula
examples/Python SDK、TypeScript SDK、OpenAI Agents SDK 和 LangChain

連接代理器

MCP 伺服器位於 https://api.specstream.ai/mcp (Streamable HTTP)。您的代理器在您的帳號下運作:使用相同的餘額、權限和消費上限。

  1. 在工作區中開啟代理器與 API 並建立 API 金鑰。僅授予任務所需的權限:讀取、準備或執行,以及允許使用的專案、到期時間和消費上限。

  2. 將金鑰放入環境變數中,這樣任何檔案都不會儲存它:

    export SPECSTREAM_API_KEY="ss_live_..."
    
  3. 依照下方說明將伺服器加入您的客戶端。

支援 MCP 登入的客戶端無需金鑰即可連接。每個指南請參閱 specstream.ai/docs/mcp,其中顯示了目前的步驟。

新帳戶可獲得 $10 的免費額度,無需信用卡。

Claude

在 Claude 中,前往 Customize > Connectors,選擇 Add custom connector,將其命名為 SpecStream 並貼上 https://api.specstream.ai/mcp。使用登入和金鑰兩種方式的步驟:docs/mcp/claude。

Claude Code

claude mcp add --transport http specstream https://api.specstream.ai/mcp \
  --header "Authorization: Bearer $SPECSTREAM_API_KEY"

或者安裝外掛,這會新增伺服器和六個技能。首次使用時會透過瀏覽器讓您登入,因此無需金鑰:

/plugin marketplace add specstream/specstream-tools
/plugin install specstream@specstream

ChatGPT

前往 ChatGPT 外掛,選擇加號按鈕,然後選擇 Add custom MCP server。在 Connection 下貼上 https://api.specstream.ai/mcp,並將 Authentication 設定為 OAuth。步驟:docs/mcp/chatgpt。

Codex

新增到 ~/.codex/config.toml:

[mcp_servers.specstream]
url = "https://api.specstream.ai/mcp"
bearer_token_env_var = "SPECSTREAM_API_KEY"

Cursor

新增到 ~/.cursor/mcp.json,或某個專案中的 .cursor/mcp.json:

{
  "mcpServers": {
    "specstream": {
      "url": "https://api.specstream.ai/mcp",
      "headers": { "Authorization": "Bearer ${env:SPECSTREAM_API_KEY}" }
    }
  }
}

VS Code

…

[為翻譯而截斷]

相關技能