illegalCreed

中文

English

中文

English

Appearance

参考 ​

基于 Tavily / Exa / SearXNG / Serper / SerpAPI / Brave Search 官方文档（2026 年）编写

Tavily ​

端点 ​

POST https://api.tavily.com/search
POST https://api.tavily.com/extract      # URL 内容抽取
POST https://api.tavily.com/crawl        # 站点爬取

Search 参数 ​

参数类型默认含义
querystring-必填，搜索词
search_depthbasic/advanced/fast/ultra-fastbasic深度
topicgeneral/news/financegeneral类别
daystring-仅 news：日期范围
time_rangestring-如 month / day / year
max_resultsint50-20
include_answerbool/basic/advancedfalseLLM 答案
include_raw_contentboolfalse全文
include_imagesboolfalse含图
include_image_descriptionsboolfalse图描述
include_domainsstring[]-仅这些域名
exclude_domainsstring[]-排除域名
chunks_per_sourceint-advanced 时每 URL 片段数
countrystring-如 us / cn

Search 响应 ​

json
{
  "query": "...",
  "answer": "LLM 生成的答案（如 include_answer=true）",
  "images": [{"url": "...", "description": "..."}],
  "results": [
    {
      "title": "...",
      "url": "...",
      "content": "片段文本",
      "raw_content": "全文（如开启）",
      "score": 0.95
    }
  ],
  "response_time": 2.3
}

价格 ​

  • basic：1 credit
  • advanced：2 credit
  • 免费 tier：1000 credits/月

Exa ​

端点 ​

POST https://api.exa.ai/search
POST https://api.exa.ai/contents          # 拿已知 URL 的内容
POST https://api.exa.ai/findSimilar       # 找相似网页
POST https://api.exa.ai/answer            # 直接答案

Search 参数 ​

参数类型默认含义
querystring-必填
numResultsint101-100
typeauto/neural/keyword/instant/fast/deep-lite/deep/deep-reasoningauto搜索模式
categorystring-research/company/news/tweet/person/pdf/github
useAutopromptboolfalse自动加引导词
includeDomainsstring[]-仅域名
excludeDomainsstring[]-排除域名
startPublishedDate/endPublishedDatestring-YYYY-MM-DD
startCrawlDate/endCrawlDatestring-爬取时间
contentsobject-见下
subpagesint-抓子页面
subpageTargetstring[]-子页路径

contents 对象 ​

json
{
  "text": {"maxCharacters": 1000, "includeHtmlTags": false},
  "highlights": {"numSentences": 3, "highlightsPerUrl": 2, "query": "..."},
  "summary": {"query": "..."},
  "livecrawl": "always" / "fallback" / "never"
}
  • text：全文
  • highlights：LLM 识别最相关片段
  • summary：LLM 总结
  • livecrawl：实时抓取（保证新鲜）

type 详解 ​

type延迟质量用途
instant最低中chat 实时
fast低高用户面向
auto中高默认
neural中高（语义）找概念相关
keyword中高（精确）找字面命中
deep-lite~4s高（含 synthesis）轻研究
deep慢最高（多步综合）深度研究
deep-reasoning最慢最高（含推理）复杂分析

价格 ​

  • 按 search credits + 内容字符计费
  • 免费 tier：1000 searches/月

Serper ​

端点 ​

POST https://google.serper.dev/search        # 通用
POST https://google.serper.dev/news          # 新闻
POST https://google.serper.dev/images        # 图片
POST https://google.serper.dev/videos        # 视频
POST https://google.serper.dev/places        # 地图
POST https://google.serper.dev/maps          # 地图详情
POST https://google.serper.dev/scholar       # 学术
POST https://google.serper.dev/shopping      # 购物
POST https://google.serper.dev/autocomplete  # 自动补全

Search 参数 ​

参数含义
q必填
num结果数
gl国家（如 us / cn）
hl语言（如 en / zh-CN）
page分页
tbs时间过滤（qdr:d=24h, qdr:w=周, qdr:m=月）
engine默认 google

响应 ​

json
{
  "organic": [
    {"title": "...", "link": "...", "snippet": "...", "position": 1, "date": "..."},
    ...
  ],
  "knowledgeGraph": {"title": "...", "description": "...", ...},
  "peopleAlsoAsk": [{"question": "...", "snippet": "...", "link": "..."}],
  "relatedSearches": ["...", "..."],
  "pagination": {...}
}

价格 ​

  • $0.30 / 1000 queries
  • 免费 tier：2500 次
  • 行业最便宜之一

SerpAPI ​

端点 ​

GET https://serpapi.com/search?engine=google&q=...&api_key=...

支持多 engine：google / bing / baidu / yandex / duckduckgo / google_scholar / google_maps / 等 30+。

参数 ​

  • engine：搜索引擎
  • q：查询
  • location：地理位置
  • google_domain / gl / hl
  • num / start（分页）
  • tbs：时间过滤
  • api_key：必填

响应 ​

与 Serper 类似，但字段更全（含 local_results / shopping_results / jobs 等多种 SERP feature）。

价格 ​

Plan价格次数/月
Free$0100
Product Hunt$505000
Startup$12515000
Business$25030000

Brave Search API ​

端点 ​

POST https://api.search.brave.com/res/v1/web/search
POST https://api.search.brave.com/res/v1/news/search
POST https://api.search.brave.com/res/v1/images/search
POST https://api.search.brave.com/res/v1/videos/search

也支持 GET（query string）。

Web Search 参数 ​

参数类型含义
qstring必填，≤400 字符/50 词
countrystring2 字母国家，或 ALL
search_langstring语言（如 en / zh-hans）
countint每页结果数
offsetint分页（最大 9）
safe_searchstrict/moderate/off安全搜索
unitsmetric/imperial单位
result_filterstring结果类型过滤
summarybool是否含 LLM 摘要
freshnessstring时间过滤（pd=24h, pw=周, pm=月）

响应 ​

json
{
  "type": "search",
  "web": {
    "results": [
      {"title": "...", "url": "...", "description": "...", "age": "...", "position": 1}
    ]
  },
  "news": {...},
  "videos": {...},
  "query": {"original": "...", "show_strict_warning": false}
}

价格 ​

  • Free：2000 queries/月
  • Pro：$0.003/查询 起

SearXNG ​

端点（自部署） ​

GET http://your-host/search?q=QUERY&format=json&engines=...&categories=...

参数 ​

参数含义
q查询
formathtml/json/csv/rss
engines引擎列表（逗号分隔，如 google,bing）
categoriesgeneral/images/news/videos/it/science/files/social media
languageall/en/zh/zh-CN
pageno页码
time_rangeday/week/month/year
safesearch0/1/2

支持 engines（70+） ​

Google / Bing / DuckDuckGo / Yahoo / Startpage / Brave / Wikipedia / GitHub / GitLab / Stack Overflow / Reddit / Hackernews / PubMed / arXiv / SoundCloud / Peertube / YouTube / 淘宝 / 京东 / 等。

配置 settings.yml ​

yaml
use_default_settings: true

server:
  bind_address: "0.0.0.0"
  port: 8080
  secret_key: "..."   # 必填

search:
  safe_search: 0
  default_lang: "zh-CN"
  formats:
    - html
    - json

outgoing:
  request_timeout: 3.0
  max_request_timeout: 10.0
  useragent_suffix: ""
  # proxies:
  #   all://: 'socks5h://...'

engines:
  - name: google
    engine: google
    shortcut: g
    disabled: false

SDK / 库 ​

服务PythonJavaScript
Tavilytavily-python@tavily/core
Exaexa_pyexa-js
Serperhttpx 直接调serper-sdk（社区）
SerpAPIgoogle-search-resultsgoogle-search-results
Bravehttpx 直接调brave-search
SearXNGhttpx 直接调直接调

LangChain 集成 ​

python
from langchain_community.tools import (
    TavilySearchResults,
    BraveSearchWrapper,
)
from langchain_community.utilities import (
    GoogleSerperAPIWrapper,
    GoogleSearchAPIWrapper,
    SearxSearchWrapper,
)

# Tavily
tavily = TavilySearchResults(max_results=5)

# Serper
serper = GoogleSerperAPIWrapper()

# Brave
brave = BraveSearchWrapper(api_key="...")

# SearXNG（自部署）
searx = SearxSearchWrapper(searx_host="http://localhost:8080")

资源链接 ​