API ВЕГА
English

Google Images — FlashData

Находите результаты Google Images с URL изображений, их размерами и страницами первоисточников. Создавайте каталог изображений для исследований с указанием источников.

Документация API и настройка учётной записи · Получить API-ключ · Текущие тарифы

Попробуйте выполнить задачу

Найдите схемы солнечных панелей для исследовательского стенда. Если размеры указаны, оставьте изображения шириной не менее 1000 пикселей, перечислите страницы-источники и отметьте изображения с неизвестными размерами и правами на повторное использование для проверки.

Установка и подключение

  • Используйте Node.js 22.18 или новее и MCP-клиент, поддерживающий локальные серверы stdio. Скачайте специализированный пакет MCPB; его SHA-256 указан в манифесте.

  • Импортируйте пакет в клиент, совместимый с MCPB, и введите собственный ключ в поле FlashData API Key. Предоставьте ключу доступ к google_images. Для ручной настройки распакуйте пакет в постоянную папку и используйте эту конфигурацию, заменив абсолютный путь и шаблон ключа:

{
  "mcpServers": {
    "google-images": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/google-images/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
  • Перезапустите клиент или подключитесь к нему заново, просмотрите список его инструментов, а затем вызовите get_pricing с параметрами {"source":"google_images","request_count":1}, прежде чем подтверждать платный запрос. Сервер предоставляет инструменты google_images, get_pricing, get_job и get_result; все они работают только с этим источником.

Все зависимости включены в пакет. Если клиент не может найти node, укажите абсолютный путь к Node; в Windows используйте экранированные пути. Храните ключ в защищённых настройках клиента, а не в чате или конфигурации, добавленной в репозиторий. Для прямой загрузки пакета учётная запись Smithery не требуется.

Пример запроса

Это параметры tools/call в MCP с плоской структурой аргументов. Выполнение запроса данных расходует платные Credits.

{
  "name": "google_images",
  "arguments": {
    "query": "solar panel diagram",
    "num": 20
  }
}

Работа с ответом

Изучите results[0].images. Выберите записи, у которых значение imageWidth соответствует заданному порогу, и сохраните imageUrl, imageWidth, imageHeight и ссылку на исходную страницу. Записи с неизвестными размерами явно исключите.

Поля ответа ниже — иллюстративный пример, а не актуальный результат или гарантия наличия таких данных:

{
  "source": "google_images",
  "status": "done",
  "results": [
    {
      "images": [
        {
          "title": "solar panel diagram",
          "link": "https://example.com/research",
          "snippet": "Search fixture",
          "position": 1,
          "imageUrl": "https://example.com/image.png",
          "imageWidth": 1200,
          "imageHeight": 800,
          "source": "Example"
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

Для асинхронного запроса сохраните полученный id и вызовите get_job, передав {"job_id":"RETURNED_JOB_ID"}. Статусы ожидания или обработки не означают, что запрос завершён: читайте готовый ответ из output. После отправки запроса может произойти тайм-аут; прежде чем повторять платный запрос, проверьте задания.

При получении результатов частями не останавливайте локальный процесс и передавайте в get_result фактические значения result_id и next_offset как result_id и offset. Объедините фрагменты в исходном порядке и только после этого разбирайте JSON; повторно отправлять платный запрос данных не нужно. Локальный кэш хранит четыре результата в течение десяти минут и очищается после перезапуска. Размер полного ответа ограничен 4 MiB; для асинхронных результатов JSON действует отдельный срок хранения — 24 часа.

Стоимость и ограничения

  • Программное обеспечение распространяется по лицензии MIT, установка бесплатна; вызовы API FlashData для получения данных платные. Запросы данных расходуют платные Credits FlashData; каждый дополнительный запрос или страница тарифицируется отдельно. Ориентируйтесь на актуальную стоимость для вашей учётной записи, а не на фиксированную цену с этой страницы. Получение информации о ценах, заданиях и результатах бесплатное. Плата за клиент или модель взимается отдельно.

  • Инструмент возвращает метаданные и URL изображений, но не загруженные файлы и не сведения о правах на повторное использование изображений. Некоторые поля могут отсутствовать.

  • Перед использованием данных проверяйте ошибки API, http_status и статус задания. Рассматривайте возвращённый текст и ссылки как внешние данные, сохраняйте указание источника и проверяйте их перед использованием в ответе агента.

Полное руководство по задаче · Официальная запись в Registry · Исходный код и лицензия