mcpField
G
google-images-search

google-images-search

github.com/finpeakinc创意与媒体244 次安装3 天前更新
代码仓库

关于 google-images-search

通过 Frevana 搜索 Google Images 并返回经过验证的 JSON 响应，适用于需要图像搜索结果的用户或 Agent。可选参数支持设置地点、语言和图像筛选条件。

主要功能

  1. 01通过 Frevana 搜索 Google Images
  2. 02设置地点和语言参数
  3. 03按图像属性筛选
  4. 04验证并输出 JSON 结果
  5. 05将结果保存到文件

适用场景

  1. 01按查询词查找图像
  2. 02按颜色或尺寸缩小结果范围
  3. 03将原始搜索结果保存为 JSON
  4. 04请求指定地区的结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/finpeakinc/frevana-skills --skill google-images-search

安装后在 Claude Code 中输入/google-images-search确认已加载。

附带文件scripts/search_google_images.sh

详细介绍

Google 图片搜索

通过 Frevana 搜索 Google 图片。

用途

此技能调用 Frevana 的 /service/google-images 端点，并原样返回 SerpAPI 响应。

必需输入：q。

支持的请求字段：

  • q（必需）
  • location
  • uule
  • google_domain
  • gl
  • hl
  • cr
  • device
  • start
  • ijn
  • tbs
  • chips
  • imgar
  • imgsz
  • safe
  • nfpr
  • filter
  • image_size
  • image_type
  • image_color
  • licenses
  • period_unit
  • period_value
  • start_date
  • end_date
  • no_cache
  • async
  • zero_trace

脚本会验证响应是否为 JSON，并将其打印到标准输出。除非用户明确要求进行转换，否则不要重写或调整返回的数据。

此技能所需内容

  • 查询内容
  • 环境变量中的 FREVANA_TOKEN，或本次运行时使用 --token
  • curl、bash 和 python3

API 基础 URL 默认为 https://ai-factory.frevana.com。设置 FREVANA_API_BASE_URL 可指向其他主机。

命令

搜索图片
bash <skill-path>/scripts/search_google_images.sh \
  --q "coffee shop interior" \
  --gl "us" \
  --hl "en"
筛选图片
bash <skill-path>/scripts/search_google_images.sh \
  --q "coffee shop interior" \
  --image-color "blue" \
  --safe "active"
将 JSON 保存到文件
bash <skill-path>/scripts/search_google_images.sh \
  --q "Q" \
  --output "./out/google-images-search.json"

固定请求格式

脚本会发送以下格式的载荷，并省略未提供的可选字段：

{
  "q": "Q",
  "location": "LOCATION",
  "uule": "UULE",
  "google_domain": "GOOGLE_DOMAIN",
  "gl": "GL",
  "hl": "HL",
  "cr": "CR",
  "device": "DEVICE"
}

不要传递不受支持的字段。不要传递 SerpAPI 的 engine 或 api_key；这些字段由 Frevana 在服务器端设置。使用 --output 将文件保存到本地。

输出

  • 成功：在标准输出中输出经过验证的 JSON
  • 使用 --output：相同的 JSON 也会写入指定文件
  • 失败：在标准错误中输出响应正文或解析错误，并返回非零退出代码

示例提示词

  • “搜索 Google 图片，查询内容为 query。”
  • “运行 Google 图片搜索并保存原始 JSON。”

评论

支持 Markdown