一个 r/n8n 线程请求一个搜索 API,该 API 返回准备放入 LLM 上下文窗口的结构化片段 - 不是原始 HTML,也不是剥离的含义。本教程在 5 分钟内将 Scavio 的 /search 端点连接到 Python 或 Node 助手。
前置条件
- Python 3.10+ 或 Node 20+
- Scavio API 密钥(每月 250 个免费积分)
操作指南
步骤 1: 获取您的 API 密钥
在 scavio.dev 上注册。免费套餐每月返还 250 个积分,无卡。
Bash
export SCAVIO_API_KEY=sk_...步骤 2: 拨打搜索电话
使用 x-api-key 标头 POST 到 /api/v1/search。
Python
import os, requests
API_KEY = os.environ['SCAVIO_API_KEY']
def search(query):
r = requests.post('https://api.scavio.dev/api/v1/search',
headers={'x-api-key': API_KEY},
json={'query': query})
return r.json()步骤 3: 仅提取 LLM 需要的字段
标题、摘要、链接。剩下的就放下吧
Python
def trim(results):
return [{'title': r['title'], 'snippet': r['snippet'], 'url': r['link']}
for r in results.get('organic_results', [])[:5]]步骤 4: 注入到提示符中
将修剪后的结果作为系统上下文的一部分传递。
Python
context = '\n'.join(f'- {r["title"]}: {r["snippet"]} ({r["url"]})' for r in trim(search('reddit api alternatives 2026')))
prompt = f'Use this context to answer the question.\n\n{context}\n\nQuestion: which APIs replace Reddit\'s direct search?'步骤 5: 当需要更多上下文时与提取端点配对
以降价形式获取顶部结果。
Python
def fetch(url):
r = requests.post('https://api.scavio.dev/api/v1/extract',
headers={'x-api-key': API_KEY}, json={'url': url, 'format': 'markdown'})
return r.json().get('markdown', '')Python 示例
Python
import os, requests
API_KEY = os.environ['SCAVIO_API_KEY']
def ask_with_search(question):
s = requests.post('https://api.scavio.dev/api/v1/search',
headers={'x-api-key': API_KEY}, json={'query': question}).json()
ctx = '\n'.join(f'{r["title"]}: {r["snippet"]}' for r in s.get('organic_results', [])[:5])
return ctx
print(ask_with_search('what is mcp'))JavaScript 示例
JavaScript
const API_KEY = process.env.SCAVIO_API_KEY;
export async function search(q) {
const r = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'x-api-key': API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ query: q })
});
return r.json();
}预期输出
JSON
Five clean snippets per query, ready to inject into the LLM's context. Token cost stays under 800 tokens for the search context block.