SuperAPI AI 工具集

suggest

通用与其它

查看项目

更新于 10-15 17:29

技能介绍

用途:为“边输入边搜索”界面提供查询自动补全/建议,也可在调用网页搜索或 llm-context 前先扩展或补全不完整、含歧义的查询,并可借助 rich 参数识别实体。

主要能力:调用 GET https://api.search.brave.com/res/v1/suggest/search,返回建议查询列表。支持参数 q(必填,1-400 字符、最多 50 词)、lang(语言,默认 en)、country(国家,默认 US,可 ALL)、count(1-20,默认 5,实际可能更少)、rich(是否附加实体信息,默认 false)。响应含 type、query.original、results 数组;results[].query 为建议补全,rich 时可能含 is_entity、title、description、img,null 字段不返回,非 rich 结果只有 query。对常见拼写错误可直接给出干净建议,无需单独纠错。

使用方式:需 API Key(https://api.search.brave.com 获取),请求头 X-Subscription-Token: <API_KEY>,可选 Accept-Encoding: gzip。示例:curl -s "https://api.search.brave.com/res/v1/suggest/search?q=how+to+" -H "Accept: application/json" -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"。带全部参数示例:curl -s "https://api.search.brave.com/res/v1/suggest/search" -H "Accept: application/json" -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" -G --data-urlencode "q=albert" --data-urlencode "country=US" --data-urlencode "lang=en" --data-urlencode "count=10" --data-urlencode "rich=true"。

适用场景:搜索框实时下拉建议(建议防抖 150-300ms)、为 RAG 扩写查询、实体预览卡片、容错输入。限制:rich=true 需付费 Search 套餐,包含在 Suggest 套餐中;lang 与 country 只是相关性提示并非严格过滤;count 为上限,实际结果可能更少;资料未提供具体价格与其他平台支持情况。