Communitygithub.com

specstream/specstream-tools

实时网络数据引擎。搜索API：全球最准确的网络搜索API，每1,000次搜索仅需5美元（specstream.ai/benchmarks）。提取API：每1,000页0.80美元。深度搜索：结构化数据行。

specstream-tools 是什么？

SpecStream是一个强大的实时网络数据引擎，专为团队和AI代理设计。它提供三大核心功能：搜索API（全球最准确的网络搜索，F-score达97.9）、提取API（提取网页、PDF、Word和Excel文件的主文本，每页仅0.0008美元）以及深度搜索（用自然语言查询，从整个实时网络中获取所有匹配项，并结构化输出为数据行）。该工具支持通过API、MCP协议以及多种集成方式（如Sheets、CRM、Slack、n8n、Zapier等）使用，并可作为Claude Code、Cursor、Codex等AI代理的插件或技能。SpecStream还提供7种主流搜索API的即插即用兼容模式，只需更改基础地址和API密钥即可无缝切换。每个搜索结果都附带来源URL和读取时间，深度搜索在运行前显示并确认费用，仅对成功交付的数据行收费。

兼容平台✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓OpenCode✓Windsurf
npx skills add https://github.com/specstream/specstream-tools/tree/main
查看原文→浏览所有技能

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

预览

来自技能 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 问题上 F-score 为97.9，在所有200个 WideSearch 任务上 item F1 为64.0（分数与方法）。在数秒内回答来自实时网络的问题。每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 网络搜索。即插即用调用运行快速搜索：每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/用于读取智能体插件格式的智能体的插件
.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 能力（托管的 MCP 服务器和四个技能）
integrations/vscode/VS Code 扩展：MCP 登录和 @specstream 聊天
actions/find-action/运行请求并上传 CSV 的 GitHub Action
Formula/命令行界面的 Homebrew 配方
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 中，转到 自定义 > 连接器，选择 添加自定义连接器，命名为 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 插件，选择加号按钮，然后选择 添加自定义 MCP 服务器。在 连接 下粘贴 https://api.specstream.ai/mcp，并将 身份验证 设置为 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

…

[内容已截断以用于翻译]

相关技能

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community