PHPackages                             tigusigalpa/yandex-search-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. tigusigalpa/yandex-search-php

ActiveLibrary[API Development](/categories/api)

tigusigalpa/yandex-search-php
=============================

PHP/Laravel SDK for Yandex Search API integration. Supports web search, generative search, image search, and keyword statistics (Wordstat).

v1.0.0(2w ago)62↓100%1MITPHPPHP ^8.0

Since Mar 6Pushed 2w ago1 watchersCompare

[ Source](https://github.com/tigusigalpa/yandex-search-php)[ Packagist](https://packagist.org/packages/tigusigalpa/yandex-search-php)[ Docs](https://github.com/tigusigalpa/yandex-search-php)[ RSS](/packages/tigusigalpa-yandex-search-php/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (7)Versions (2)Used By (0)

Yandex Search PHP SDK
=====================

[](#yandex-search-php-sdk)

[![Yandex Search PHP SDK](https://private-user-images.githubusercontent.com/2721390/559028072-863bba30-6a15-4eb6-bcf5-f3ed9c19139a.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQyNTE5NjUsIm5iZiI6MTc3NDI1MTY2NSwicGF0aCI6Ii8yNzIxMzkwLzU1OTAyODA3Mi04NjNiYmEzMC02YTE1LTRlYjYtYmNmNS1mM2VkOWMxOTEzOWEucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDMyMyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjAzMjNUMDc0MTA1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MmNiNmE5ZmZlOWI4MzExN2QzMTEwZjBiYzhjZjE4ODQzMTc1YWViNjU1ZTlhN2IwMWU3YTJjOGY0NGZiMjBkNSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.uRcaNqo68vVt51PD8gdQQaBZSdnUncI3n9gLkOg-W54)](https://private-user-images.githubusercontent.com/2721390/559028072-863bba30-6a15-4eb6-bcf5-f3ed9c19139a.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQyNTE5NjUsIm5iZiI6MTc3NDI1MTY2NSwicGF0aCI6Ii8yNzIxMzkwLzU1OTAyODA3Mi04NjNiYmEzMC02YTE1LTRlYjYtYmNmNS1mM2VkOWMxOTEzOWEucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDMyMyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjAzMjNUMDc0MTA1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MmNiNmE5ZmZlOWI4MzExN2QzMTEwZjBiYzhjZjE4ODQzMTc1YWViNjU1ZTlhN2IwMWU3YTJjOGY0NGZiMjBkNSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.uRcaNqo68vVt51PD8gdQQaBZSdnUncI3n9gLkOg-W54)

[![Latest Version](https://camo.githubusercontent.com/0bffe4fa2a607e70baafda5738b0f4ddc786088ceefd892882bcc57f884c73e6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f74696775736967616c70612f79616e6465782d7365617263682d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tigusigalpa/yandex-search-php)[![PHP Version](https://camo.githubusercontent.com/dd1c82f7bd4c75a3f2415a6c3609ef1ffb709c0c5598b540282e1dd6a64d773e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f74696775736967616c70612f79616e6465782d7365617263682d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tigusigalpa/yandex-search-php)[![License](https://camo.githubusercontent.com/6ef687897db48be0cfe4af42faaaeff2c8bd12c8f25f35fb69fbfe9f92cd3435/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f74696775736967616c70612f79616e6465782d7365617263682d7068702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/tigusigalpa/yandex-search-php)

PHP 8.0+ SDK, который даёт доступ ко всем возможностям [Yandex Search API](https://aistudio.yandex.ru/docs/ru/search-api/concepts/index.html) прямо из вашего PHP- или Laravel-приложения. Классический веб-поиск, генеративные ответы от ИИ, поиск картинок, аналитика ключевых слов — всё в одном пакете.

> Часть экосистемы Яндекса для PHP:
> [yandex-cloud-client-php](https://github.com/tigusigalpa/yandex-cloud-client-php) · [yandexgpt-php](https://github.com/tigusigalpa/yandexgpt-php)

[🇬🇧 English version](README-en.md)

> 📖 **[Полная документация доступна на Wiki](https://github.com/tigusigalpa/yandex-search-php/wiki)**

Что внутри
----------

[](#что-внутри)

- **Веб-поиск** — текстовый поиск с сортировкой, группировкой, регионами и семейным фильтром
- **Генеративный поиск** — задайте вопрос, получите ответ от ИИ с реальными источниками (на базе YandexGPT)
- **Поиск изображений** — ищите по описанию или загружайте картинку для обратного поиска
- **Wordstat** — популярность ключевых слов, динамика, распределение по регионам (как Яндекс Вордстат, только через API)
- **Асинхронность** — запускайте поиск и забирайте результат позже
- **Типобезопасные DTO** — каждый ответ API приходит в виде объекта, а не сырого массива
- **Готовность к Laravel** — service provider, фасад, публикация конфига, DI — всё из коробки
- **Тестируемость** — подставьте мок HTTP-клиента и тестируйте без обращений к реальному API

Требования
----------

[](#требования)

- PHP 8.0+
- Аккаунт [Yandex Cloud](https://cloud.yandex.ru/) с подключённым Search API
- OAuth-токен (как получить — см. [oauth.yandex.ru](https://oauth.yandex.ru/))

Установка
---------

[](#установка)

```
composer require tigusigalpa/yandex-search-php
```

Пакет зависит от [`tigusigalpa/yandex-cloud-client-php`](https://github.com/tigusigalpa/yandex-cloud-client-php) для аутентификации

Быстрый старт
-------------

[](#быстрый-старт)

### Обычный PHP

[](#обычный-php)

Три строки до первого поиска:

```
