HasData Google Images

Google Images MCP 服务

一个托管的模型上下文协议（MCP）服务，为 Claude、Cursor、Windsurf 及其他任何 MCP 客户端提供一个只读的 Google Images 工具。使用尺寸、颜色和类型筛选条件执行图片搜索，每次调用可获取 100 条结果；每条结果都包含其来源页面和原始分辨率文件 URL，并以结构化 JSON 返回，无需托管任何内容。

它读取已退出登录的访客看到的 Google Images 结果页面。

每月提供 1,000 个免费额度，无需信用卡，按每次调用 10 个额度计算，相当于可调用 Google Images 100 次。

https://mcp.hasdata.com/mcp?apis=google_images

• 提示词和资源

目录

• 所需条件
• 快速开始
• 提示词示例
• 工具
• 错误和故障处理路径
• 定价、免费额度和限制
• 对比
• 常见问题
• HasData 链接
• 开发
• 贡献
• 许可证

所需条件

一个 MCP 客户端，以及一个从 控制面板 获取的 HasData API 密钥；免费创建，无需信用卡，免费额度按每次调用 10 个额度计算，每月约可调用 100 次。这是一个远程服务，因此最简单的接入方式是使用 URL 和 x-api-key 标头，无需运行容器。只支持 stdio 的客户端可通过一个轻量启动器连接该服务；该启动器已发布到 npm，包名为 @hasdata/google-images-mcp，以及 PyPI，包名为 hasdata-google-images-mcp，如下所示。

快速开始

所有客户端使用的服务器 URL 都相同。我们在 Claude Code 和 Claude Desktop 中提供了实际配置示例。其他代码块遵循各客户端针对远程服务所记录的格式。

支持 OAuth 的客户端可以将同一 URL 添加为连接器，然后登录，无需在配置文件中填写密钥。

claude mcp add --transport http google-images "https://mcp.hasdata.com/mcp?apis=google_images" \
  --header "x-api-key: HASDATA_API_KEY"

{
  "mcpServers": {
    "google-images": {
      "command": "npx",
      "args": ["-y", "@hasdata/google-images-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-images": {
      "command": "uvx",
      "args": ["hasdata-google-images-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-images": {
      "url": "https://mcp.hasdata.com/mcp?apis=google_images",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "google-images": {
      "serverUrl": "https://mcp.hasdata.com/mcp?apis=google_images",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "servers": {
    "google-images": {
      "type": "http",
      "url": "https://mcp.hasdata.com/mcp?apis=google_images",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

示例提示词

• 查找奥斯汀天际线的图片，并列出宽度超过 1500 像素的图片。
• 哪些网站为这个产品名称的图片排在搜索结果前列？
• 搜索此查询的黑白照片，跳过剪贴画和线描图。
• 使用德国 Google 搜索此查询，并将来源与美国的来源进行比较。
• 查找这个地标的图片，并告诉我哪些是图库照片。
• 获取此查询的下一页结果。

每次调用都能回答上述问题，因为每页包含 100 条结果。只有需要获取更多结果时才需要翻页。

工具

一个工具，每次成功调用消耗 10 个额度。

获取图像搜索结果

hasdata_google_images_images_getImageSearchResults

一页 Google Images 搜索结果。

返回一个 imagesResults 数组。每个条目包含 position、title、托管图像的网页链接 link、作为网站名称的 source、Google CDN 上的 thumbnail、作为全分辨率文件的 original，以及 originalWidth 和 originalHeight。

{
  "position": 1,
  "title": "The city skyline of Austin, Texas - Backyard Image",
  "link": "https://www.backyardimage.com/the-city-skyline-of-austin-texas/",
  "source": "Backyard Image",
  "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSOGtSVdgWtQtW1_x8-gi7iQckNHXBQ5FdKqEpCKXsbWg&s=10",
  "original": "https://www.backyardimage.com/wp-content/uploads/2025/01/2025-01-12-drone-Heap-0015-Pano-Edit.jpg",
  "originalWidth": 1200,
  "originalHeight": 615
}

tbs 参数是 Google 自有的筛选字符串，多个筛选条件可以用逗号组合。

提示词和资源

服务提供 5 个资源，每个资源对应一个可接受值为固定列表的参数。读取资源比通过失败的调用来了解可用词汇更省事，而且不消耗额度。每个 URI 的格式为 hasdata://google_images/<parameter>。

该列表无需 API 密钥即可提供，因此客户端可以在用户注册前读取。

错误和失败路径

请为这些情况做好准备，而不是假设一切都会顺利。

original 是第三方 URL，可能失效、被禁止盗链或响应缓慢。 它指向托管该文件的网站上的文件，因此不具备 Google 的可用性保障。请谨慎抓取，并在必要时回退到由 Google CDN 提供的 thumbnail。

thumbnail 是 Google CDN 链接，不是嵌入式图片。 它是一个真实的 URL，而非数据 URI，因此显示它仍会向 gstatic.com 发起请求。

每页包含 100 条结果，而不是 10 条。 费用按调用次数而非结果数量计算，因此一次调用获取 100 张图片是这里成本最低的方式。只有超过前 100 条时才使用 ijn。

ijn 从零开始。 传入 1 会获取第二页，而不是第一页。

尺寸描述的是原图，而不是缩略图。 originalWidth 和 originalHeight 指的是 original 背后的文件，因此在本地应用尺寸筛选时，应读取这些值，而不是测量显示的图片。

tbs 值由 Google 定义，不识别的值会被忽略，而不会被拒绝。 筛选条件无声地不起作用，看起来和筛选出所有结果一样，因此在信任手动拼接的 tbs 字符串之前，请确认结果确实缩小了范围。

domain、gl 和 hl 是三个独立维度。 域名决定 Google 从哪里返回结果，国家/地区代码决定搜索来自哪里，语言决定界面语言。更改其中一项对结果的影响可能比预期小。

包含数据的结果也会包含值得在支持请求中引用的 requestMetadata.id。

定价、免费额度和限制

Google Images 工具每次成功调用收费 10 个额度。响应大小不会改变价格，每次调用会返回 100 条结果，因此按返回的每行结果计算，这是目录中成本较低的工具之一。

免费额度为每月 1,000 个额度，无需绑定银行卡，按基础费率可调用 100 次 Google Images。额度会随计费周期续期，因此低调用量的 Agent 可以无限期使用免费额度。

付费套餐起价为每月 59 美元，包含 200,000 个额度，即 20,000 次调用。调用量越大，单价越低：入门套餐每 1,000 次调用为 1.48 美元，Basic 为 0.60 美元，Growth 系列为 0.41 美元。当前价格请查看定价页面。

套餐还决定并发限制。免费套餐允许同时发起 1 个请求，Startup 为 5 个，Basic 为 15 个，Growth 系列则为 50 到 500 个。对于无人值守的任务，请在遇到 429 时采用退避策略重试，因为扫描关键词列表的 Agent 会比你更早触及上限。

返回非 200 状态码的请求不会计费。成功调用但没有找到结果，仍然会计为一次调用。

对比

Google 的 Custom Search JSON API 是获取图片结果的官方途径，但用途范围更窄。

决定性差异在于搜索范围。可编程搜索引擎只覆盖你配置的网站；若要用它搜索开放网络，则需要额外设置，而且结果仍与用户看到的页面有所不同。如果你能控制要搜索的网站，那么官方 API 在低调用量下是免费的，也更适合这种情况。

常见问题

Google 是否提供官方的 Google Images MCP 服务？

Google 没有发布此类服务。此服务由 HasData 维护，读取 Google Images 公共页面。

什么是 Google Images MCP 服务？

MCP 服务会公开 AI 客户端可以调用的工具。这个服务会将 Google Images 结果页转换为 JSON，供 Agent 分析，无需在技术栈中使用浏览器或抓取库。

我需要 Google 账号或 Cloud 项目吗？

不需要。唯一需要的凭证是 HasData 密钥。

我可以下载图片吗？

响应会提供 original，即托管该文件的网站上的文件 URL。是否可以下载、存储或复用该文件，属于有关该图片的版权问题，不能仅凭 Google 将其编入索引来判断。除非你已确认图片不受保护，否则应假定它受保护。

我可以按图片而不是文本搜索吗？

不可以。此工具接受文本查询。反向图片搜索使用的是另一个端点。

如何按尺寸筛选？

通过 tbs 筛选。isz:l 可获取大图，isz:lt,islt:2mp 可获取尺寸大于 1600×1200 的图片，而 isz:ex,iszw:1000,iszh:1000 可获取尺寸恰好为 1000×1000 的图片。筛选条件可用逗号组合。

我可以将此服务与其他 HasData API 一起使用吗？

可以。一个密钥即可用于所有服务，而一个端点通过 apis 参数提供所有服务。将客户端指向 ?apis=google_images,google_serp，即可在一个连接中获取两组工具；也可以指向 mcp.hasdata.com/mcp，查看完整目录。

HasData 与 Google 有关联吗？

没有。HasData 是一项独立服务，与 Google 无关联，也未获得 Google 的认可或赞助。Google 是其各自所有者的商标。这些工具仅处理公开数据，你有责任确保使用结果时遵守 Google 的条款以及适用于你的法律。

合规与个人数据

图片搜索会返回与查询匹配的内容，因此，查询中提到某个人就会返回该人的图片，而 itp:face 则专门搜索人脸。可识别个人身份的图片属于个人数据；在多个司法管辖区，生物特征数据处理还受到单独且更严格的监管。在开始之前，最需要认真考虑的就是基于这些结果构建人脸集合，而不是等到事后再考虑。

HasData 链接

• Google Images API，此工具所用的 REST 端点
• API 文档
• MCP 服务文档
• 定价
• 控制台

其他 HasData MCP 服务：Google Search、Google Maps、Google Trends、Google Flights、Bing、DuckDuckGo、YouTube、TikTok、Instagram、Amazon、Walmart、Shopify、Yelp、Yellow Pages、Zillow、Redfin、Airbnb、Booking.com、Indeed、Glassdoor。

开发

启动器是连接远程服务的轻量级 stdio 桥接，因此无需构建。

npm install
HASDATA_API_KEY=your_key_here npm test

test/ 中的测试会验证工具契约，也就是无需在此提交代码就可能发生变化的部分。它们会检查 ?apis=google_images 是否返回预期的唯一工具、工具名称是否保持不变、是否仍要求提供 q 且附带描述、本 README 所述的筛选和目标定位参数是否仍在架构中，以及当前使用的密钥是否确实可用。最后一项检查会实际调用工具，耗费 10 个积分；这是一次可能因正确原因而失败的金丝雀测试。

有一项测试会验证实时搜索是否返回同时包含 original 和其尺寸的结果。这三个字段正是这个工具比普通 SERP 更值得调用的原因；如果解析器发生变化并丢弃这些字段，工具列表仍会显示通过，但这些字段就会缺失。

契约测试套件还会按周定期运行，因为上游工具列表可能会在无人改动此仓库的情况下发生变化。

贡献

如果工具表、响应示例或文档说明的行为与实际情况不符，欢迎提交 issue。我们专门为此准备了模板。欢迎提交相关 pull request，也欢迎为启动器中的任何内容提交 pull request。

许可证

MIT，详见 LICENSE。