SuperAPI AI 工具集

local-descriptions

通用与其它

查看项目

更新于 10-15 17:29

技能介绍

用途:为本地商户或兴趣点(POI)获取 AI 生成的文字描述,用于补充结构化地点数据、旅行内容或搜索结果。

主要能力:GET https://api.search.brave.com/res/v1/local/descriptions,通过 ids 参数传入 POI ID(1-20 个,可重复 ?ids=a&ids=b),返回 type 为 local_descriptions 的结果数组,每项含 id 与 description。描述固定为 markdown 格式,通常 200-400 字,带旅行指南语气。

必要用法:需 API Key,请求头带 X-Subscription-Token: <API_KEY>。POI ID 来自 local-place-search,或 web-search 加 result_filter=locations 后取 locations.results[].id。示例:curl -s "https://api.search.brave.com/res/v1/local/descriptions?ids=..." -H "Accept: application/json" -H "Accept-Encoding: gzip" -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"。

适用场景:本地商户概览(配合 local-pois 获取营业时间、评分等)、旅游与目的地指南、搜索结果增强。

限制:POI ID 为不透明字符串,约 8 小时有效,需重新获取;描述由 AI 基于网络搜索上下文生成,非来自商户资料;并非所有 POI 都有描述,description 可能为 null;单次最多 20 个 ID。API Key 获取与订阅计划见官方链接。