Communitygithub.com

specstream/specstream-tools

라이브 웹 데이터 엔진: 가장 정확한 웹 검색 API($5/1,000회 검색), 추출 API($0.80/1,000페이지), 심층 검색(구조화된 행)을 제공합니다.

specstream-tools란 무엇인가요?

이 스킬은 SpecStream 플랫폼을 통해 AI 에이전트(Claude, Cursor, Codex 등)가 실시간 웹 데이터를 검색, 추출, 강화 및 모니터링할 수 있도록 합니다. Search API는 업계 최고 수준의 정확도(SimpleQA Verified 1,000개 질문에서 F-score 97.9)로 웹 검색을 수행하며, Extract API는 한 번의 호출로 최대 20개 웹 페이지, PDF, Word 또는 Excel 파일의 본문 텍스트를 추출합니다. Deep Search 기능은 자연어 질문으로 전체 웹에서 일치하는 모든 결과를 구조화된 행으로 제공하고, 기존 목록을 강화하거나 변경 사항을 모니터링할 수도 있습니다. 주요 기능으로는 Tavily, Exa, Brave Search, Serper 등 기존 API의 드롭인 대체(drop-in replacement)를 지원하며, MCP(Model Context Protocol) 서버를 통해 Claude, ChatGPT, Cursor, VS Code 등 다양한 플랫폼에 통합할 수 있습니다. 모든 작업은 사용자 계정의 잔액과 설정한 지출 한도 내에서 이루어지며, 새로운 계정에는 카드 등록 없이 $10 크레딧이 제공됩니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓OpenCode✓Windsurf
npx skills add https://github.com/specstream/specstream-tools/tree/main

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

미리보기

스킬 README에서

요청, 가격, 소스가 포함된 행
PyPI
npm
n8n node
MCP Registry
Add to Replit
specstream-tools preview

문서

웹 전체에서 데이터를 구축, 검색, 추출, 강화, 매핑 및 모니터링하는 하나의 플랫폼입니다.

데이터셋을 평범한 문장으로 요청하면 SpecStream이 전체 라이브 웹에서 이를 구축합니다. 모든 일치 항목을 찾아 구조화된 레코드로 추출 및 강화한 후 변경 사항을 모니터링합니다. API와 MCP를 통해 실행되며, Sheets, CRM, Slack, n8n, Zapier 및 팀이 이미 사용하는 다른 도구 내부에서도 작동합니다.

제품기능가격
Search APIGET /v1/web-search. 세계에서 가장 정확한 웹 검색 API: 모든 1,000개 SimpleQA Verified 질문에서 F-score 97.9, 모든 200개 WideSearch 작업에서 항목 F1 64.0 (점수 및 방법). 라이브 웹에서 몇 초 만에 질문에 답변합니다.$5/1,000회 검색, speed=fast 사용 시 $1/1,000회
Extract APIPOST /v1/extract. 한 번 호출로 최대 20개의 웹 페이지, PDF, Word 또는 Excel 파일의 주요 텍스트를 추출합니다. MCP 도구는 read_pages입니다.$0.80/1,000페이지. 텍스트가 없는 페이지는 청구되지 않습니다.
Deep Search평범한 문장으로 질문하세요. 라이브 웹의 모든 일치 항목을 구조화된 행으로 얻을 수 있습니다. 또한 기존 목록을 강화하고 변경 사항을 모니터링합니다.행당 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용 Search 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용 Extract 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용 Search 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용 Extract 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과 읽기 시간이 포함됩니다.
  • Search API와 Extract API는 견적이나 승인이 필요하지 않습니다. 각 검색 또는 페이지는 잔액에서 고정 가격으로 차감됩니다.
  • Deep Search에서는 실행 전에 최대 비용이 표시되고 승인됩니다. 전달된 행에 대해서만 청구되며, 아무것도 찾지 못한 실행은 비용이 발생하지 않습니다.
  • 저장된 요청은 매시간에서 매년까지 재실행되며, 각 행은 변경됨, 변경되지 않음, 더 이상 일치하지 않음으로 표시됩니다.
  • 귀하의 에이전트는 귀하의 계정에서, 귀하가 설정한 지출 한도 내에서 작동합니다.

이미 사용 중인 API를 위한 드롭인

SpecStream은 자체 주소에서, 각 API의 자체 응답 형태로 이러한 검색 API에 대해 작성된 호출에 응답합니다. 전환하려면 기본 주소와 키를 변경하면 됩니다. 각 검색 호출은 SpecStream 키에서 하나의 Search API 웹 검색입니다. 드롭인 호출은 빠른 검색을 실행합니다: 최대 10개 결과에 $0.001($1/1,000회 검색), 동일 호출에서 결과 10개 추가 시 $0.0012 추가. 답변 또는 API의 정밀 모드를 요청하는 호출은 기본 검색을 실행합니다: 최대 10개 결과에 $0.005, 결과 10개 추가 시 $0.006.

호출하는 API기존 기본 주소SpecStream 주소SpecStream 키 위치
Tavilyhttps://api.tavily.comhttps://api.specstream.ai/tavilyBearer 토큰 또는 api_key
Exahttps://api.exa.aihttps://api.specstream.ai/exax-api-key 또는 Bearer 토큰
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 토큰
Firecrawl v2https://api.firecrawl.devhttps://api.specstream.ai/firecrawl (JavaScript SDK 및 앱) 또는 https://api.specstream.ai (Python SDK)Bearer 토큰

공식 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입니다. 20개 결과를 원하면 count=20을 보내면 $0.0022입니다.
  • Firecrawl /v2/scrape 호출은 Extract API 페이지 1회로 $0.0008입니다. Firecrawl JavaScript SDK는 이 주소에서 작동합니다. Firecrawl Python SDK는 호스트 루트를 사용합니다: Firecrawl(api_key=..., api_url="https://api.specstream.ai").
  • 각 라우트의 요청 및 응답 필드: specstream.ai/agents.md. specstream.ai/workspace의 Agents & 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 서버 및 6가지 스킬)
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 서버 및 4가지 스킬)
integrations/openclaw/@specstream/openclaw-plugin: OpenClaw 플러그인 (목록 찾기, 행 읽기, 4가지 스킬)
integrations/pi/@specstream/pi-package: Pi 패키지 (호스팅 MCP 서버 및 4가지 스킬)
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/tap-specstream (PyPI): Meltano 및 모든 Singer 대상, 목록 및 각 값의 소스 페이지를 위한 Singer 탭
integrations/coda/Coda Pack: 모든 값에 소스 열이 있는 테이블로 목록 동기화, 요청 가격 책정, 버튼에서 목록 찾기
plugins/grok/Grok Build 플러그인 (호스팅 MCP 서버 및 4가지 스킬)
plugins/kiro/Kiro 파워 (호스팅 MCP 서버 및 4가지 스킬)
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. 워크스페이스의 Agents & 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"

또는 플러그인을 설치하면 서버와 6가지 스킬이 추가됩니다. 처음에 브라우저를 통해 로그인하므로 키가 필요하지 않습니다:

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

ChatGPT

ChatGPT Plugins로 이동하여 더하기 버튼을 선택한 후 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

…

[번역을 위해 잘림]

관련 스킬