SpecStream

为团队和 Agent 提供实时网络数据引擎。

网站  ·  文档  ·  定价  ·  MCP 注册表

从实时网络获取完整列表，供你的 Agent 使用。每一行都附有来源，并在运行前报价。用日常语言提出你需要的列表，就能获得完整结果：只包含匹配项，每项都注明来源页面，内容保持最新，并发送到你的工作平台。你只需为匹配项付费。

你的 Agent 请求“德克萨斯州的食物银行及其年度收入”，就会得到可供引用的行，每行都附有来源页面。它会先看到价格；如果搜索没有结果，则无需付费。

此仓库包含围绕 SpecStream 安装的内容：MCP 客户端配置、Agent 插件和技能、SDK、n8n 节点、GitHub Action 以及示例。产品本身运行在 specstream.ai。采用 MIT 许可证。

路径	内容
server.json	官方 MCP Registry 条目，ai.specstream/specstream
skills/	Agent 技能：compile、review-work、approve-work、continue-work
plugins/claude-code/	Claude Code 插件（MCP 服务和四项技能）
plugins/github-agent/	面向可读取 agent-plugins 格式的 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 列表获取器组件和 Agent 工具
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 Agent 技能，另提供 MCP 路由
integrations/convex/	Convex 组件（@specstream/convex）：将实时网络数据作为记录写入 Convex 表格，并为每个值提供来源
integrations/fivetran/	Fivetran Connector SDK 连接器：在数据仓库中存放列表、记录，以及每个值对应的来源页面
integrations/airbyte/	Airbyte 源（仅清单）：列表和记录，以及每个值对应的来源页面
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/	GitHub Action：运行请求并上传 CSV
Formula/	命令行的 Homebrew formula
examples/	Python SDK、TypeScript SDK、OpenAI Agents SDK 和 LangChain

连接 Agent

MCP 服务地址为 https://api.specstream.ai/mcp（Streamable HTTP，97 个工具）。你的 Agent 使用你的账户：共享你的余额、权限和支出限额。

1. 在工作区中打开 Agents & API，并创建一个 API 密钥。仅授予任务所需的权限：读取、准备或执行；指定可使用的项目、有效期和支出限额。

2. 将密钥放入环境变量中，避免将它保存在任何文件中：

   export SPECSTREAM_API_KEY="ss_live_..."
   

3. 将服务添加到下方列出的客户端。

支持 MCP 登录的客户端无需密钥即可连接。每份指南都展示了当前的操作步骤：specstream.ai/docs/mcp。

新账户可在 30 天内免费使用价值 $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

添加到 .vscode/mcp.json。VS Code 会提示你输入一次密钥，并将密钥保存在文件之外。

{
  "inputs": [
    { "type": "promptString", "id": "specstream-key", "description": "SpecStream API key", "password": true }
  ],
  "servers": {
    "specstream": {
      "type": "http",
      "url": "https://api.specstream.ai/mcp",
      "headers": { "Authorization": "Bearer ${input:specstream-key}" }
    }
  }
}

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

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

Zed、Cline 和 Continue

Cline 也支持通过 OAuth 登录直接连接托管服务：cline mcp install specstream --transport http https://api.specstream.ai/mcp。Zed 和 Continue，以及偏好使用密钥的 Cline，请使用 stdio 代理。它只会转发环境变量中的密钥，不会转发其他内容。

pip install specstream-mcp-stdio

Zed，添加到 settings.json 中：

{
  "context_servers": {
    "specstream": {
      "command": "specstream-mcp-stdio",
      "args": [],
      "env": { "SPECSTREAM_MCP_URL": "https://api.specstream.ai/mcp" }
    }
  }
}

Cline，添加到 cline_mcp_settings.json 中：

{
  "mcpServers": {
    "specstream": {
      "command": "specstream-mcp-stdio",
      "args": [],
      "env": { "SPECSTREAM_MCP_URL": "https://api.specstream.ai/mcp" }
    }
  }
}

Continue，添加到 .continue/mcpServers/specstream.yaml 中：

name: SpecStream
version: 1.0.0
schema: v1
mcpServers:
  - name: specstream
    type: stdio
    command: specstream-mcp-stdio
    args: []
    env:
      SPECSTREAM_MCP_URL: https://api.specstream.ai/mcp
      SPECSTREAM_API_KEY: ${{ secrets.SPECSTREAM_API_KEY }}

在设置了 SPECSTREAM_API_KEY 的 shell 中启动 Zed 和 Cline。为他人安装 SpecStream 的 Agent 可参阅 llms-install.md。

Gemini CLI

安装扩展（包含 MCP 服务，以及显示价格并等待确认的说明）：

gemini extensions install https://github.com/specstream/specstream-tools

也可以只添加服务：

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

或添加到 ~/.gemini/settings.json 中：

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

OpenCode

将插件添加到 opencode.json。它会添加 SpecStream 服务和四个技能，并且 opencode mcp auth specstream 会通过浏览器为你登录：

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-specstream"]
}

详情和选项：integrations/opencode。

Replit

该按钮会将 SpecStream 添加到 Replit Agent；Project Editor 提示时登录即可。链接中无需包含密钥。

任何支持输入 URL 的其他客户端

Lovable、Gumloop、Relevance AI、Lindy、Manus、Genspark 等：添加远程 MCP 服务，粘贴 https://api.specstream.ai/mcp，并在提示时登录。如果客户端只支持填写请求头，请使用 Authorization: Bearer $SPECSTREAM_API_KEY。

可使用 A2A 通信的 Agent

SpecStream 也是一个 A2A Agent。Agent Card 位于 https://api.specstream.ai/.well-known/agent-card.json（A2A 1.0，包含 0.3 字段），JSON-RPC 端点为 https://api.specstream.ai/a2a。没有密钥时，它会复述请求并报价：

curl -s https://api.specstream.ai/a2a -H 'Content-Type: application/json' -H 'A2A-Version: 1.0' \
  -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"messageId":"m1","role":"ROLE_USER","parts":[{"text":"Plumbers in Denver with a phone number"}]}}}'

使用 Authorization: Bearer $SPECSTREAM_API_KEY（或 OAuth 令牌）后，回复会变成等待审批的任务。向任务回复一个数据部分 {"confirm_max_cents": N}，其中 N 是报价的最高金额，即可运行；GetTask 会返回各行数据，每个值都带有对应的 source_url。

n8n

从 Settings > Community nodes 安装社区节点：n8n-nodes-specstream。它会读取请求、显示报价、按你输入的最高金额批准，并返回结果。三个可导入的工作流位于 integrations/n8n/workflows。n8n 中的 AI Agent 也可以使用 MCP Client Tool 节点，端点为 https://api.specstream.ai/mcp，传输方式为 HTTP Streamable，并使用 Bearer 凭据。

LangChain

pip install -U langchain-specstream

from langchain.agents import create_agent
from langchain_specstream import specstream_tools

agent = create_agent("anthropic:claude-sonnet-5-5", tools=specstream_tools(max_price_usd=5))

提供两个工具和一个检索器。Agent 编写请求并选择行数；价格上限保留在你的代码中，大模型无法提高该上限。每行结果都会附带读取它的页面。详情见 packages/langchain-specstream。

如需通过 MCP 加载所有 SpecStream 工具：

import os
from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "specstream": {
        "transport": "streamable_http",
        "url": "https://api.specstream.ai/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['SPECSTREAM_API_KEY']}"},
    }
})
tools = await client.get_tools()

完整 Agent 示例位于 examples/langchain-mcp。

LlamaIndex

pip install -U llama-index-tools-specstream

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.tools.specstream import SpecStreamToolSpec

agent = FunctionAgent(tools=SpecStreamToolSpec(max_price_usd=5).to_tool_list(), llm=llm)

提供与工具规范相同的两个工具，以及一个检索器；检索器会为每行结果返回一个节点，并在元数据中附上来源。价格上限保留在规范中，大模型无法更改。详情见 packages/llama-index-tools-specstream。

CrewAI

pip install -U crewai-specstream

from crewai import Agent
from crewai_specstream import specstream_tools

analyst = Agent(role="Funding analyst", goal="Answer with a source for every claim",
                backstory="You work from lists, not from memory.", tools=specstream_tools(max_price_usd=5))

提供与 CrewAI 工具相同的两个工具，密钥会作为机密保存，异步 Crew 也不会被阻塞。详情见 packages/crewai-specstream。

Vercel AI SDK

npm install @specstream/ai-sdk ai zod

import { generateText, stepCountIs } from "ai";
import { specstreamTools } from "@specstream/ai-sdk";

const { text } = await generateText({
  model: "openai/gpt-5-mini",
  tools: specstreamTools({ maxPriceUsd: 5 }),
  stopWhen: stepCountIs(5),
  prompt: "Find dental clinics in Lisbon with online booking, with their website.",
});

兼容 AI SDK 6 和 7。详情见 packages/ai-sdk。

OpenAI Agents SDK

import os
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    name="SpecStream",
    params={
        "url": "https://api.specstream.ai/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['SPECSTREAM_API_KEY']}"},
    },
    cache_tools_list=True,
) as server:
    agent = Agent(name="Researcher", instructions="Use SpecStream for lists.", mcp_servers=[server])
    result = await Runner.run(agent, "Food banks in Texas, with their annual revenue. Show me the price first.")

完整 Agent 示例位于 examples/openai-agents-sdk。

任何其他支持通过 Streamable HTTP 使用远程 MCP 的客户端，都可以使用上述地址和 Authorization: Bearer 标头。

Agent 的工作流程

除非有人（或在某人设定的限额内运行的 Agent）批准价格，否则不会产生任何费用。

1. compile 读取请求，并返回 SpecStream 对请求的理解：事物类型、每个结果都必须满足的条件，以及需要返回的事实。
2. quote_capacity_work 返回价格和工作可能产生的最高费用。报价有效期为 30 分钟。
3. authorize_capacity_work 批准该准确报价，并传入以美分为单位的最高金额（confirm_max_cents）和稳定的 idempotency_key，以确保重试不会重复扣费。
4. get_find 显示进度，并随行数据到达逐步更新。list_find_rows 返回结果，以及每条事实的原因和来源。
5. export_find、share_find 和 send_to_destination 用于转移结果。读取、导出和分享均免费。

每条交付的结果根据所含事实数量收费 10 美分、30 美分或 1 美元。未找到结果的搜索免费。详情见定价。

skills/ 中的四项技能会教 Agent 遵循此流程，并在何时停下并询问：compile、review-work、approve-work、continue-work。

SDK 和命令行

pip install specstream-client        # Python 3.12+, import specstream_client, command: specstream
npm install @specstream/sdk          # Node 22+
brew tap specstream/specstream-tools https://github.com/specstream/specstream-tools
brew install specstream              # the command line

import os
from specstream_client import Client

client = Client(os.environ["SPECSTREAM_API_KEY"])
read = client.compile("Datasets on urban tree canopy published since 2020 under an open license.")
offer = client.quote_capacity_work({
    "ast_hash": read["ast_hash"], "operation": "find",
    "requested_units": read["ast"]["limit"]["max"],
})
print(offer["maximum_cents"], offer["expires_at"])

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

const client = new Client({ apiKey: process.env.SPECSTREAM_API_KEY! });
const read = await client.compile("Datasets on urban tree canopy published since 2020 under an open license.");

可端到端运行请求的脚本示例位于 examples/python-sdk 和 examples/typescript-sdk。

GitHub Action

- uses: specstream/specstream-tools/actions/find-action@v1
  with:
    request: Open tenders on SAM.gov for translation services with a deadline after November 1. Include the buyer and the estimated value.
    api_key: ${{ secrets.SPECSTREAM_API_KEY }}
    confirm_max_usd: "10"

如果价格超过 confirm_max_usd，此步骤会停止。

三个请求

像跟同事沟通那样说出你的需求。这些请求来自产品中的请求模板。

德国有 50 至 500 名员工、正在招聘销售人员的软件公司。包括招聘信息和联系邮箱。 每家公司一行，列出公司规模、销售职位招聘信息和公司公布的联系邮箱。每行用一句话说明它为何符合要求，并附上每项信息的来源页面。SpecStream 无法确认的公司会单独列出，且不收费。

SAM.gov 上截止日期晚于 11 月 1 日的翻译服务公开招标。包括采购方和预估金额。 每条公告一行，列出采购方、预估金额、截止日期和公告链接。代码会将截止日期与您提供的日期进行比较。

GitHub 上星标超过 1,000、最近一个月内有推送记录且采用 MIT 或 Apache 许可证的 Rust 命令行工具。 每个代码仓库一行，列出星标数、最近推送时间和许可证。代码会将星标数和日期与您提供的数字进行比较，每行都链接到相应的代码仓库。

数据会从相关来源中读取：注册平台和官方 API、地图和目录、招聘网站、研究索引、新闻以及各结果自身的网站。SpecStream 会在您提出请求时读取数据。

文档与支持

• 入门指南、API、SDK、MCP
• 定价
• Agent 指南和 llms.txt
• 支持：[email protected]
• 安全问题报告：请参阅 SECURITY.md

许可证

MIT。请参阅 LICENSE。SpecStream 服务受其条款约束。