getascraper/how-to-scrape-yandex-reverse-image
GitHub: getascraper/how-to-scrape-yandex-reverse-image
该爬虫通过 Yandex Images 实现大规模反向图片搜索，将相似图片、来源页面、标签等匹配结果以结构化数据批量输出。
Stars: 0 | Forks: 0
# Yandex 反向图片搜索爬虫：相似图片与来源页面
[](https://apify.com/getascraper/yandex-reverse-image-scraper)
[](https://apify.com/getascraper/yandex-reverse-image-scraper)
[](https://apify.com/getascraper/yandex-reverse-image-scraper)
[](https://github.com/getascraper/how-to-scrape-yandex-reverse-image/issues)
[](https://github.com/getascraper/how-to-scrape-yandex-reverse-image/commits/main)
大规模进行 Yandex 反向图片搜索。提交图片 URL 并获取相似图片、来源页面、标签以及其他尺寸的结构化数据。无需登录。
[](https://apify.com/getascraper/yandex-reverse-image-scraper)
## 为什么使用 Yandex 反向图片搜索爬虫
* **一次性搜索整个批次**：单次运行可提交一张或数百张图片，且每个结果都会保留与其来源图片的关联标签。
* **一个数据集中包含五种匹配类型**：相似图片、匹配页面、文本标签、其他尺寸和购物匹配，全部呈现在一个扁平表格中。
* **无需账户或登录**：该 Actor 读取公开的 Yandex Images 结果，因此无需进行任何登录操作。
* **仅提供真实数据**：省略缺失的字段，而不是用占位符填充，并且没有虚构的相似度评分。
* **覆盖西方工具遗漏的范围**：Yandex 通常能找出俄罗斯和独联体（CIS）网站上的匹配结果，而其他反向图片搜索引擎并未将这些网站编入索引。
## 如何使用 Yandex 反向图片搜索爬虫
1. 将一个或多个公开的图片 URL 粘贴到 **Image URLs** 中。
2. 打开或关闭所需的匹配类别，如果希望运行规模较小，可以设置一个 **Max results per image** 上限。
3. 点击 **Start**：爬虫将收集每条匹配记录，并为每个项目写入一行扁平数据。
4. **下载您的结果**：从 Output 标签页导出为 Excel、CSV、JSON 或 HTML 格式。
## 输入
| 字段 | 类型 | 必填 | 描述 |
| --- | --- | :---: | --- |
| `imageUrls` | 字符串数组 | 是 | 要在 Yandex Images 上搜索的一个或多个公开的直接图片 URL。 |
| `maxResultsPerImage` | 整数 | 否 | 限制每张图片每个类别返回的匹配数量。默认值为 20。 |
| `includeSimilarImages` | 布尔值 | 否 | 返回视觉上相似的图片。默认开启。 |
| `includeMatchingPages` | 布尔值 | 否 | 返回使用该图片的网页。默认开启。 |
| `includeTags` | 布尔值 | 否 | 返回 Yandex 对图片猜测的最佳文本标签。默认开启。 |
| `includeOtherSizes` | 布尔值 | 否 | 返回其他分辨率下的图片副本。默认开启。 |
| `includeShoppingMatches` | 布尔值 | 否 | 如果存在，返回与图片相关的商品列表。默认开启。 |
| `proxyConfiguration` | 对象 | 否 | 用于访问 Yandex 的代理。默认设置即可直接使用。 |
## 输出
数据集中的每一行都是一次匹配，并标记了其来源的输入图片。所有字段均为扁平结构，没有嵌套数据，因此可以在任何电子表格软件中顺畅打开。
```
{
"inputImageUrl": "https://example.com/product-photo.jpg",
"matchType": "matching_page",
"title": "Winter Down Jacket, Navy: Online Store",
"url": "https://shop.example.ru/catalog/down-jacket-navy",
"imageUrl": "https://avatars.mds.yandex.net/get-images/123/orig",
"width": 1200,
"height": 1600,
"sourceDomain": "shop.example.ru",
"description": "Navy down jacket, sizes S to XXL, free shipping across Russia.",
"scrapedAt": "2026-07-09T10:22:41.508Z"
}
```
### 数据表
| 字段 | 类型 | 描述 |
| --- | :---: | --- |
| `inputImageUrl` | 文本 | 此行匹配结果来源的输入图片。 |
| `matchType` | 枚举 | 匹配类型：相似图片、匹配页面、标签、其他尺寸或购物匹配。 |
| `title` | 文本 | 匹配结果的标题，例如页面标题或产品名称。 |
| `url` | 文本 | 指向匹配结果的链接：使用该图片的页面、相似图片、标签搜索或商品列表。 |
| `imageUrl` | 文本 | 指向匹配图片文件的直接链接。 |
| `width` | 整数 | 匹配图片的像素宽度。 |
| `height` | 整数 | 匹配图片的像素高度。 |
| `sourceDomain` | 文本 | 使用该图片的页面域名，仅适用于匹配页面行。 |
| `description` | 文本 | 使用该图片的页面中的简短文本片段，仅适用于匹配页面行。 |
| `scrapedAt` | 文本 | 找到匹配项时的时间戳。 |
## 定价
**每张图片匹配 $0.0044（每 1,000 条结果 $4.40）。** 无包月订阅，无最低承诺要求。新的 Apify 账户包含 $5 的免费使用额度，您可以先试用再付款。
您只需为实际返回的匹配结果付费，如果没有匹配结果，则不收取任何费用。
## 快速开始
从 `.env.example` 创建一个 `.env` 文件，添加您的 [Apify API token](https://console.apify.com/account/integrations)，然后运行：
```
npm install
npm start
```
该脚本使用 [Apify API 客户端](https://docs.apify.com/api/client/js/) 来启动 [Yandex 反向图片搜索爬虫](https://apify.com/getascraper/yandex-reverse-image-scraper) 并获取结果。
## 提示与优化
* **使用直接图片链接**：以 .jpg、.png 或 .webp 结尾的链接比指向图片所在页面的链接效果更好。
* **关闭不需要的类别**：只保留您实际使用的匹配类型，可以使运行更加精简、结果更加聚焦。
* **在探索性运行中限制结果数量**：首先设置较低的每张图片最大结果数，待了解单张图片通常返回的匹配数量后再提高该限制。
* **安排定期运行**：随着时间的推移监控同一组图片，以捕捉开始使用您照片的新页面。
## 常见问题
**我可以在一次运行中搜索多张图片吗？**
可以。将所有图片 URL 添加到 Image URLs 字段中并开始一次运行。每张图片都会被单独搜索，并且每条结果行都会标记其来源图片。
**我能找出哪些网站在使用我的图片吗？**
可以。保持开启匹配页面功能，爬虫将返回使用每张图片的页面，以及页面标题、域名和简短的文本片段。
**为什么某一行中会缺少某些字段？**
Yandex 并不会报告每次匹配的所有细节。爬虫不会进行猜测，而是直接省略这些字段，以确保数据的准确性。因为没有得到 Yandex 的提供，所以这里没有虚构的相似度或置信度评分。
**我需要登录 Yandex 才能使用吗？**
不需要。该爬虫读取的是公开的反向图片搜索结果，任何访问者都可以在 Yandex Images 上看到这些结果。
## 支持
如需报告 Bug、反馈缺失字段或提出功能请求，请在 [Issues](https://github.com/getascraper/how-to-scrape-yandex-reverse-image/issues) 标签页下开启一个 issue。标签：API, BeEF, MITM代理, URL抓取, 图像搜索, 数据可视化, 数据抓取, 爬虫, 网络调试, 自动化, 自定义脚本