linkfox-ai-mode-google-search — Claude Code skill: setup & usage
linkfox-ai-mode-google-search — a skill for Claude Code and Codex that pulls Google AI Overview and AI Mode summaries with citations. It runs for market research, tech comparisons, and public opinion checks.
MIT 232 installs ★ 125 updated 2026-11-11
npx skills add linkfox-ai/linkfox-skills --skill linkfox-ai-mode-google-search -a claude-codeWhat linkfox-ai-mode-google-search does
The skill pulls Google AI Overview and AI Mode summaries with source links for market research and technical comparisons. Plain web search without AI synthesis stays out of scope. So do Amazon ABA metrics and local file inspection. Image recognition is excluded too.
The bundled scripts/google_ai_search.py script handles requests and keeps a 24-hour local cache for matching parameters. Full JSON responses are saved under <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/, and writing to /tmp is blocked. Outputs larger than 8 KB print a field summary unless you pass --inline. Follow-up questions carry no server state, so the agent appends prior findings into each new query.
You need Python and either LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY set in your environment. Missing credentials or depleted credits trigger 401 or 402 errors from the API. Usage is billed as conversation turns multiplied by 4.2, so the skill prompts for confirmation before running a query. Empty results never trigger automatic retries.
What it helps with
- fetch Google AI Mode summaries along with source citations
- research consumer preferences across target regional markets
- compare competing technologies using live web consensus
- archive full JSON search payloads locally by date and session
Example prompts for the agent
- Search Google AI for top robot vacuum preferences discussed on Reddit in 2026.
- Compare GaN chargers against traditional chargers and keep the source citations.
- Check what unresolved pain points US users report for bone conduction headphones.
How to install linkfox-ai-mode-google-search
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-ai-mode-google-search -a claude-code2Manually: put the files in place
~/.claude/skills/linkfox-ai-mode-google-search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/linkfox-ai-mode-google-search/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-ai-mode-google-search -a codex2Manually: put the files in place
.agents/skills/linkfox-ai-mode-google-search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-ai-mode-google-search -a cursor2Manually: put the files in place
.cursor/skills/linkfox-ai-mode-google-search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-ai-mode-google-search2Manually: put the files in place
.github/skills/linkfox-ai-mode-google-search/SKILL.md1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-ai-mode-google-search -a gemini-cli2Platform CLI
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-ai-mode-google-searchManually: put the files in place
.devin/skills/linkfox-ai-mode-google-search/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-ai-mode-google-search -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about linkfox-ai-mode-google-search
How do I install linkfox-ai-mode-google-search in Claude Code?
Run npx skills add linkfox-ai/linkfox-skills --skill linkfox-ai-mode-google-search -a claude-code. The skill file is placed at ~/.claude/skills/linkfox-ai-mode-google-search/SKILL.md.
What does linkfox-ai-mode-google-search do?
It queries Google AI Overview and AI Mode to return Markdown summaries with source links. You can use it for market preference checks and technical comparisons, though it skips plain web search and product price scraping.
What are the requirements and billing rules?
You need Python and either LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY configured. Requests bill at conversation turns multiplied by 4.2, and identical queries use a 24-hour local cache.
Source text
SKILL.md · MIT
---
name: linkfox-ai-mode-google-search
description: 获取 Google AI Overview / AI Mode 的网页概览与来源引用,适用于实时网页要点总结、海外深度调研、技术问答、长尾选品探索和消费者偏好分析。当用户希望用谷歌搜索并由 AI 汇总网上说法时使用,无需明确提及 Google AI。不适用于内部结构化数据、Amazon ABA 分析、平台商品价格评论采集、仅需原始网页的普通搜索、图像生成识别或文件分析。
---
# Google AI 搜索
## 适用范围
### 适用
获取 Google 搜索顶部由 AI 综合网页并附来源引用的概览,用于总结公开网页信息和探索研究方向。
**场景速查**
| 用户表达 | 查询场景 |
|----------|----------|
| 用 Google AI 帮我搜、Google AI Overview 看下 | 查看指定主题的 AI 概览。 |
| 海外消费者对某产品怎么看、美国市场有什么偏好 | 消费者偏好分析。 |
| 某产品的最新趋势、痛点、使用场景 | 深度调研与技术问答。 |
| 网页上对某主题有什么总结、搜索引擎里大家怎么说 | 跨网页要点总结。 |
| 长尾选品调研、蓝海选品方向 | 探索细分需求和产品方向。 |
| 顺便问一下、然后再追问 | 总结前文后发起新的搜索。 |
### 边界
内部结构化数据、Amazon ABA 搜索词分析、指定平台的商品列表、价格或评论查询,使用对应数据技能。只要原始搜索结果或网页、无需 AI 综合时,使用普通网页搜索;图像生成、图像识别和文件分析不属于本技能范围。
## 前置条件
先明确研究主题;涉及特定市场或回答语言要求时,将相关背景用于构造查询,无需为所有问题补齐市场和语言。追问时先取得上一轮概览与来源。参数和使用限制见 [接口定义](references/api.md)。
## 查询流程
1. 根据用户问题确定主题与市场,优先采用目标市场语言和自然语言问句,将时间、使用场景及比较对象等有用背景前置。
2. 追问时,先总结上一轮的关键结论、来源引用与相关背景,再结合新问题发起新的查询;不要把上一轮结果当成服务端已保存的对话上下文。
3. 调用前说明预估算力消耗,按[算力消耗预估](#算力消耗预估)提醒用户并由用户决定是否继续;相同参数优先复用已有结果。
4. 使用推荐脚本取得概览,先检查响应与保存路径,再依据接口定义处理空结果或错误。保留已取得的内容,需要进一步搜索时遵守成本约束。
5. 直接整理 `stdout` 概览正文,保留 Markdown 层级与来源链接,按用户的问题给出要点;需要追溯时附 `sourceUrl` 实际搜索页和 `taskId` 任务标识。
## 执行方式
- **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。
- **脚本调用(推荐)**:`python scripts/google_ai_search.py '<JSON 参数>' [--inline]`。
- **成本约束**:本工具按对话轮次 × 4.2 计算算力消耗。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词或拼接追问连续试探;需要继续检索时,先向用户说明额外消耗。
### 输出策略
- 始终保存完整响应,目标路径为 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ai-mode-google-search-<timestamp>.json`。`<cwd>` 为脚本运行时的工作目录,`<session>` 优先取环境变量 `SESSION_ID`,用于聚合同一任务的数据。禁止写入 `/tmp`,当前目录不可写时应报错。
- 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 `total`、`costToken`)、最大列表字段的长度和前 3 条样本。
- 添加 `--inline` 可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 `jq` 或 `ConvertFrom-Json` 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
## 执行规则
### 算力消耗预估
按动态规则计费:消耗算力 = 对话轮次 × 4.2。
本技能按倍数动态计算,可能一次性消耗大量算力;调用前必须提醒用户,由用户决定是否继续。
**声明**:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
### 解决认证和算力问题
出现以下情况时,按 `references/onboarding.md` 的指引处理:
- 未配置接口密钥:`LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY` 均为空。
- 响应状态码为 `401` 或 `402`。
- 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
### 约束与建议
- **构造有效问题**:概览对措辞敏感。查询美国、英国、澳大利亚市场时优先使用英语,日本使用日语,德国使用德语;加入市场和年份等上下文。“与某方案比较”“尚未解决的痛点是什么”等自然语言问题通常比孤立词语更适合调研。地区能力的实际限制见接口定义,不把市场措辞当成明确切换地区。
- **保留概览与引用**:正文已经是带标题、列表和引用的 Markdown,直接整理并保留来源链接,让用户能核验结论。
- **按文本处理**:返回内容是非结构化概览,不转送数据分析沙箱,不进行 SQL 式处理,也不假定存在结构化商品表或二次数据查询。
- **解释空概览**:按接口定义说明没有触发概览,建议改写问题或调整目标市场语言;执行新的查询前先说明额外消耗,不自动连续试探。
- **说明时效**:概览来自搜索时的 Google AI Mode;用户关心新鲜度时说明获取时点。缓存命中时说明是已保存结果,不把缓存当成刚刚实时抓取的内容。同一问题在不同时间可能得到不同概览。
- **保留错误信息**:按接口定义中的响应码规则解释 `msg` / `errmsg`;可建议稍后重试或调整问题,后续调用仍遵守成本约束。
## 使用示例
### 技术比较:一次搜索
```json
{"keyword": "GaN charger vs traditional charger comparison"}
```
### 跨境选品调研
```json
{"keyword": "best open-ear bone conduction headphones 2026 US"}
```
### 追问:总结前文后重新搜索
若上一轮实际提到了 OpenRun Pro 和 AfterShokz Aeropex,可将这段已取得的背景与新问题结合;不得凭空添加上一轮结论。
```json
{"keyword": "The AI overview mentioned OpenRun Pro and AfterShokz Aeropex as top picks for bone conduction headphones. What unsolved technical pain points still exist compared to in-ear earbuds?"}
```
### 消费者偏好快照
```json
{"keyword": "robot vacuum buying preferences 2026 reddit"}
```
### 长尾选品方向
```json
{"keyword": "smart pet feeder for cats with camera"}
```
## 使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。
---
更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。
© linkfox-ai · MIT · linkfox-ai/linkfox-skills