Skill: BuddyMe 普通搜索 / BuddyMe List Search

> 🏭 专业 Agent 检索基础设施 / Professional Agent Search Infrastructure
>
> 多引擎聚合 · 秒级响应 · 生产可用 —— 为 Agent 工作流量身打造。
> Multi-engine aggregation · seconds-fast · production-ready — purpose-built for Agent workflows.
>
> - 聚合 Google / Bing / Brave / Wikipedia 等主流引擎，垃圾结果已门控
> Aggregates major engines with junk-result gating
> - 即调即得的稳定 JSON 契约，免费注册即可接入 Agent
> Stable JSON contract, instant integration for your Agent, free with signup

触发条件 / When to Use

当用户需要搜索网页信息、获取多引擎聚合的搜索结果列表时使用本技能。
Use this skill when the user needs to search the web and get an aggregated,
multi-engine result list (titles, URLs, snippets).

前置条件 / Prerequisites

需要一枚 BuddyMe 站点通用 API Key（bk- 开头）。
You need a BuddyMe site API key (starts with bk-).

• 获取方式 / How to get one: 注册并登录 https://www.buddyme.cn ，进入控制面板
  （/panel）申请「站点通用 API Key」。
• Register and log in at https://www.buddyme.cn , open the control panel (/panel)
  and apply for the "站点通用 API Key".
• 明文只在申请时显示一次，请妥善保存；丢失可在面板重新生成（旧 Key 立即作废）。
• The plaintext key is shown only once at issuance. Store it safely; if lost,
  regenerate in the panel (the old key is revoked immediately).

推荐通过环境变量传入，避免硬编码：
Pass the key via environment variable instead of hardcoding:

export BUDDYME_API_KEY="bk-xxxxxxxxxxxxxxxxx"

步骤 / Steps

1. 确认已设置 BUDDYME_API_KEY（或使用 --key 参数）。
   Make sure BUDDYME_API_KEY is set (or pass --key).
2. 调用脚本发起搜索。
   Run the script to search.

python3 scripts/search_list.py --q "flask 教程"
python3 scripts/search_list.py --q "LLM agent" --pageno 2 --json

3. 解析输出：默认按行打印 标题 | URL | 摘要；--json 输出原始 JSON
   （含 results[{title,url,content,engine}] 与 suggestions）。
   Parse the output: by default one result per line as
   title | url | snippet; with --json the raw API payload is printed.

边界与限制 / Boundaries & Limits

• 每分钟每 IP 最多 20 次调用，超限返回 429。
  Rate limit: 20 calls per minute per IP; HTTP 429 when exceeded.
• 每次查询至多约 10 页（pageno 1~10）。
  At most ~10 pages per query (pageno 1-10).
• 结果仅供学习研究，请合规使用，勿恶意高频调用。
  Results are for study/research only. Use responsibly.
• 无需 Key 也能匿名调用；带 Key/JWT 的成功调用会累计到你的 API 使用统计。
  Anonymous calls work; authenticated successful calls are counted.

输出格式 / Output Format

[1] Flask 教程 | 菜鸟教程 | https://www.runoob.com/flask/ | (摘要前 80 字…)

故障排查 / Troubleshooting