Швидкий старт
Три кроки від порожнього акаунта до першого живого результату.
- Створіть акаунт і токен у розділі API-токени. Повне значення токена показується один раз, тож збережіть його в менеджері секретів.
- Перші 100 пошуків безкоштовні. Поповніть баланс карткою або в USDT чи USDC на сторінці Баланс, коли знадобиться більше; ціна й калькулятор вартості — на сторінці цін.
- Надішліть запит нижче зі своїм токеном. У відповіді буде поточна видача Google для цього ринку.
curl -X POST https://api.serper.live/v1/search \
-H "Authorization: Bearer sl_live_YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query":"best coffee shops","country":"AE"}'
const response = await fetch('https://api.serper.live/v1/search', {
method: 'POST',
headers: {
Authorization: 'Bearer sl_live_YOUR_TOKEN',
'Content-Type': 'application/json',
},
body: JSON.stringify({ query: 'best coffee shops', country: 'AE' }),
signal: AbortSignal.timeout(100000),
});
const result = await response.json();
console.log(result.organic);
import requests
response = requests.post(
"https://api.serper.live/v1/search",
headers={"Authorization": "Bearer sl_live_YOUR_TOKEN"},
json={"query": "best coffee shops", "country": "AE"},
timeout=100,
)
print(response.json()["organic"])
<?php
$context = stream_context_create(['http' => [
'method' => 'POST',
'header' => "Authorization: Bearer sl_live_YOUR_TOKEN\r\nContent-Type: application/json",
'content' => json_encode(['query' => 'best coffee shops', 'country' => 'AE']),
'timeout' => 100,
]]);
$result = json_decode(file_get_contents('https://api.serper.live/v1/search', false, $context), true);
print_r($result['organic']);
Живий пошук зазвичай відповідає за 2–3 секунди; перший запит до ринку після паузи триває довше, поки там відкривається свіжа сесія Google. Тримайте тайм-аут клієнта щонайменше 100 секунд, щоб повільний перший запит ніколи не падав на вашому боці.
Автентифікація
Кожен запит до /v1/search передає ваш токен у заголовку Authorization:
Authorization: Bearer sl_live_YOUR_TOKEN
- Токени починаються з
sl_live_і створюються в розділі API-токени. Створюйте окремий токен для кожного застосунку, щоб відкликати його, не зачіпаючи інших. - Тримайте токени на своєму сервері. Ніколи не вбудовуйте їх у браузер, мобільний застосунок чи публічний репозиторій.
- Відкликаний токен перестає працювати одразу; історія його запитів лишається у вашому акаунті.
| HTTP | Код | Значення |
|---|---|---|
| 401 | unauthorized |
Відсутній заголовок Authorization. |
| 401 | invalid_token |
Токен має неправильний формат, відкликаний або невідомий. |
Пошук
POST https://api.serper.live/v1/search
Виконує один живий пошук Google і повертає органічні результати. Запит і відповідь у JSON; тіло запиту обмежене 16 КБ.
Тіло запиту
| Поле | Тип | Обов’язкове | Опис |
|---|---|---|---|
query |
string | так | 2–120 символів. Пробіли згортаються; керівні символи відхиляються. |
country |
string | так | Дволітерний ISO-код ринку, наприклад AE. Має бути одним із кодів з GET /v1/countries. |
language |
string | ні | Мова інтерфейсу Google (hl), наприклад tr, en або pt-BR. Типово мова країни. |
device |
string | ні | desktop (типово) або mobile. Змінює профіль браузера, а отже й компонування видачі. |
limit |
integer | ні | Кількість органічних результатів, 1–100. Типово 10. Кожна розпочата десятка резервує одну ціну: limit 25 резервує три, а оплачуються лише десятки, що отримали результати. |
Відповідь
| Поле | Опис |
|---|---|
requestId |
UUID цього запиту. Він є в історії запитів; вказуйте його, коли повідомляєте про проблему. |
query, country, language, device |
Нормалізовані значення, які було фактично використано. |
fetchedAt |
Часова мітка живого пошуку в ISO 8601. |
latencyMs |
Тривалість живого пошуку в мілісекундах. |
pages |
Десятки результатів, на які вистачило результатів: не більше, ніж ви запитали, 0 — коли Google нічого не знайшов. |
freePages |
Скільки з цих десяток покрито безкоштовними пошуками вашого акаунта: вони витрачаються раніше за баланс. |
price, currency |
Вартість цього запиту числом у USD: ціна ринку, помножена на платні десятки (pages мінус freePages). 0, коли нічого не знайдено або запит покрили безкоштовні пошуки. |
organic[] |
Органічні результати в порядку ранжування: position, title, url, domain і snippet. snippet дорівнює null, коли Google не показує опис. |
peopleAlsoAsk[] |
Питання з блоку Google «Люди також запитують» («People also ask») простими рядками в порядку сторінки; порожній масив, коли Google його не показує. |
relatedSearches[] |
Схожі запити, які Google пропонує під результатами («People also search for»), простими рядками без повторів; порожній масив, коли їх немає. |
{
"requestId": "0199860b-2f4e-7a1c-9b3d-5e6f70819a2b",
"query": "best coffee shops",
"country": "AE",
"language": "en",
"device": "desktop",
"fetchedAt": "2026-09-28T14:00:00.000Z",
"latencyMs": 1873,
"pages": 1,
"freePages": 0,
"price": 0.005,
"currency": "USD",
"organic": [
{
"position": 1,
"title": "The 12 best coffee shops in town",
"url": "https://example.com/guides/best-coffee-shops",
"domain": "example.com",
"snippet": "A curated list of specialty coffee shops, updated every month."
},
{
"position": 2,
"title": "Coffee shops near me",
"url": "https://maps.example.org/coffee",
"domain": "maps.example.org",
"snippet": null
}
],
"peopleAlsoAsk": [
"What is the best coffee shop in town?",
"How much does a specialty coffee cost?"
],
"relatedSearches": [
"best coffee shops near me",
"specialty coffee roasters",
"coffee shop with wifi"
]
}
limit, без власних навігаційних елементів Google і без дублікатів.Органічні результати: поля organic[]
Кожен елемент organic[] — один органічний результат у тому порядку, в якому їх показує Google. Власні навігаційні елементи Google і дублікати відкидаються, а результати збираються з кількох сторінок видачі, доки не буде досягнуто limit.
Поля однакові для desktop і mobile та для всіх ринків:
| Поле | Тип | Опис |
|---|---|---|
position |
integer | Позиція серед органічних результатів, від 1 до limit (щонайбільше 100), наскрізно по сторінках видачі Google. Рахуються лише органічні елементи, тож саме це число зберігає трекер позицій. |
title |
string | Заголовок результату, як він показаний на сторінці. |
url |
string | Повна адреса результату. |
domain |
string | Хост із url, наприклад maps.example.org. Порівнюйте це поле, коли шукаєте сайт. |
snippet |
string або null | Опис під заголовком; null, коли Google його не показує. |
Країни
GET https://api.serper.live/v1/countries
Публічний, токен не потрібен. Повертає ринки, відкриті просто зараз, і типову мову Google для кожного; кожен ринок підтримує і desktop, і mobile.
curl https://api.serper.live/v1/countries
const response = await fetch('https://api.serper.live/v1/countries');
const { countries } = await response.json();
console.log(countries);
import requests
response = requests.get("https://api.serper.live/v1/countries", timeout=10)
print(response.json()["countries"])
<?php
$result = json_decode(file_get_contents('https://api.serper.live/v1/countries'), true);
print_r($result['countries']);
{
"countries": [
{
"code": "AE",
"defaultLanguage": "ar"
},
{
"code": "AL",
"defaultLanguage": "sq"
},
{
"code": "AM",
"defaultLanguage": "hy"
},
{
"code": "AO",
"defaultLanguage": "pt"
},
{
"code": "AR",
"defaultLanguage": "es"
},
{
"code": "AT",
"defaultLanguage": "de"
},
{
"code": "AU",
"defaultLanguage": "en"
},
{
"code": "AZ",
"defaultLanguage": "az"
},
{
"code": "BA",
"defaultLanguage": "bs"
},
{
"code": "BD",
"defaultLanguage": "bn"
},
{
"code": "BE",
"defaultLanguage": "nl"
},
{
"code": "BG",
"defaultLanguage": "bg"
},
{
"code": "BH",
"defaultLanguage": "ar"
},
{
"code": "BO",
"defaultLanguage": "es"
},
{
"code": "BR",
"defaultLanguage": "pt"
},
{
"code": "CA",
"defaultLanguage": "en"
},
{
"code": "CD",
"defaultLanguage": "fr"
},
{
"code": "CH",
"defaultLanguage": "de"
},
{
"code": "CI",
"defaultLanguage": "fr"
},
{
"code": "CL",
"defaultLanguage": "es"
},
{
"code": "CO",
"defaultLanguage": "es"
},
{
"code": "CR",
"defaultLanguage": "es"
},
{
"code": "CY",
"defaultLanguage": "el"
},
{
"code": "CZ",
"defaultLanguage": "cs"
},
{
"code": "DE",
"defaultLanguage": "de"
},
{
"code": "DK",
"defaultLanguage": "da"
},
{
"code": "DO",
"defaultLanguage": "es"
},
{
"code": "DZ",
"defaultLanguage": "ar"
},
{
"code": "EC",
"defaultLanguage": "es"
},
{
"code": "EE",
"defaultLanguage": "et"
},
{
"code": "EG",
"defaultLanguage": "ar"
},
{
"code": "ES",
"defaultLanguage": "es"
},
{
"code": "ET",
"defaultLanguage": "am"
},
{
"code": "FI",
"defaultLanguage": "fi"
},
{
"code": "FR",
"defaultLanguage": "fr"
},
{
"code": "GB",
"defaultLanguage": "en"
},
{
"code": "GE",
"defaultLanguage": "ka"
},
{
"code": "GH",
"defaultLanguage": "ak"
},
{
"code": "GR",
"defaultLanguage": "el"
},
{
"code": "GT",
"defaultLanguage": "es"
},
{
"code": "HK",
"defaultLanguage": "zh"
},
{
"code": "HN",
"defaultLanguage": "es"
},
{
"code": "HR",
"defaultLanguage": "hr"
},
{
"code": "HU",
"defaultLanguage": "hu"
},
{
"code": "ID",
"defaultLanguage": "id"
},
{
"code": "IE",
"defaultLanguage": "en"
},
{
"code": "IL",
"defaultLanguage": "he"
},
{
"code": "IN",
"defaultLanguage": "hi"
},
{
"code": "IQ",
"defaultLanguage": "ar"
},
{
"code": "IS",
"defaultLanguage": "is"
},
{
"code": "IT",
"defaultLanguage": "it"
},
{
"code": "JM",
"defaultLanguage": "en"
},
{
"code": "JO",
"defaultLanguage": "ar"
},
{
"code": "JP",
"defaultLanguage": "ja"
},
{
"code": "KE",
"defaultLanguage": "sw"
},
{
"code": "KG",
"defaultLanguage": "ky"
},
{
"code": "KH",
"defaultLanguage": "km"
},
{
"code": "KR",
"defaultLanguage": "ko"
},
{
"code": "KW",
"defaultLanguage": "ar"
},
{
"code": "KZ",
"defaultLanguage": "ru"
},
{
"code": "LB",
"defaultLanguage": "ar"
},
{
"code": "LK",
"defaultLanguage": "si"
},
{
"code": "LT",
"defaultLanguage": "lt"
},
{
"code": "LU",
"defaultLanguage": "fr"
},
{
"code": "LV",
"defaultLanguage": "lv"
},
{
"code": "MA",
"defaultLanguage": "ar"
},
{
"code": "MD",
"defaultLanguage": "ro"
},
{
"code": "MK",
"defaultLanguage": "mk"
},
{
"code": "MM",
"defaultLanguage": "my"
},
{
"code": "MN",
"defaultLanguage": "mn"
},
{
"code": "MT",
"defaultLanguage": "mt"
},
{
"code": "MX",
"defaultLanguage": "es"
},
{
"code": "MY",
"defaultLanguage": "ms"
},
{
"code": "MZ",
"defaultLanguage": "pt"
},
{
"code": "NG",
"defaultLanguage": "en"
},
{
"code": "NI",
"defaultLanguage": "es"
},
{
"code": "NL",
"defaultLanguage": "nl"
},
{
"code": "NO",
"defaultLanguage": "nb"
},
{
"code": "NP",
"defaultLanguage": "ne"
},
{
"code": "NZ",
"defaultLanguage": "en"
},
{
"code": "OM",
"defaultLanguage": "ar"
},
{
"code": "PA",
"defaultLanguage": "es"
},
{
"code": "PE",
"defaultLanguage": "es"
},
{
"code": "PH",
"defaultLanguage": "fil"
},
{
"code": "PK",
"defaultLanguage": "ur"
},
{
"code": "PL",
"defaultLanguage": "pl"
},
{
"code": "PR",
"defaultLanguage": "es"
},
{
"code": "PT",
"defaultLanguage": "pt"
},
{
"code": "PY",
"defaultLanguage": "gn"
},
{
"code": "QA",
"defaultLanguage": "ar"
},
{
"code": "RO",
"defaultLanguage": "ro"
},
{
"code": "RS",
"defaultLanguage": "sr"
},
{
"code": "SA",
"defaultLanguage": "ar"
},
{
"code": "SE",
"defaultLanguage": "sv"
},
{
"code": "SG",
"defaultLanguage": "en"
},
{
"code": "SI",
"defaultLanguage": "sl"
},
{
"code": "SK",
"defaultLanguage": "sk"
},
{
"code": "SN",
"defaultLanguage": "wo"
},
{
"code": "SV",
"defaultLanguage": "es"
},
{
"code": "TH",
"defaultLanguage": "th"
},
{
"code": "TN",
"defaultLanguage": "ar"
},
{
"code": "TR",
"defaultLanguage": "tr"
},
{
"code": "TW",
"defaultLanguage": "zh"
},
{
"code": "TZ",
"defaultLanguage": "sw"
},
{
"code": "UA",
"defaultLanguage": "uk"
},
{
"code": "UG",
"defaultLanguage": "sw"
},
{
"code": "US",
"defaultLanguage": "en"
},
{
"code": "UY",
"defaultLanguage": "es"
},
{
"code": "UZ",
"defaultLanguage": "uz"
},
{
"code": "VE",
"defaultLanguage": "es"
},
{
"code": "VN",
"defaultLanguage": "vi"
},
{
"code": "ZA",
"defaultLanguage": "en"
},
{
"code": "ZM",
"defaultLanguage": "en"
},
{
"code": "ZW",
"defaultLanguage": "sn"
}
]
}
Нові ринки з’являються в цій відповіді й на сторінці цін у міру запуску. Запит для закритого ринку повертає 422 country_unavailable разом зі списком доступних кодів.
Тарифікація
На вашому акаунті є передплачений баланс у USD, а починається він зі 100 безкоштовних пошуків. До початку пошуку кожен запит резервує поточну ціну свого ринку за кожну розпочату десятку результатів: limit до 10 резервує одну ціну, limit 25 — три. Безкоштовні пошуки покривають перші десятки запиту ще до того, як резервуються гроші.
- Успішний пошук: ціна списується за кожну десятку, на яку вистачило результатів, а решта резерву одразу повертається на баланс.
limit50 і 12 результатів коштують дві ціни, а не п’ять; пошук, що нічого не знайшов, не коштує нічого. - Безкоштовні пошуки: кожен новий акаунт отримує їх 100, по одному на десятку результатів, на будь-якому ринку й пристрої. Запит витрачає їх раніше за баланс, а десятки без результатів повертаються до безкоштовних так само, як гроші повертаються на баланс;
freePagesу відповіді каже, скільки десяток запит узяв із них. - Невдалий пошук, тобто відповідь
408,424чи будь-яка5xx: резерв знімається автоматично. Ви ніколи не платите за результат, якого не отримали. - Ціни можуть змінюватися з часом, але ціна, зарезервована для запиту, що вже виконується, не змінюється ніколи.
- Недостатньо коштів:
402 insufficient_balance. Поповніть баланс на сторінці Баланс; кошти доступні за кілька хвилин після підтвердження депозиту.
Кожен запит, його статус і вартість перелічені в історії запитів; кожна зміна балансу є в журналі на сторінці балансу.
Помилки
Помилки повертаються як JSON із машинозчитуваним кодом error, зрозумілим людині message і, якщо запит уже створено, його requestId:
{
"error": "insufficient_balance",
"message": "The balance does not cover one request",
"requestId": "0199860b-2f4e-7a1c-9b3d-5e6f70819a2b"
}
| HTTP | Код | Значення | Повторювати? |
|---|---|---|---|
| 400 |
invalid_json
|
Тіло не є коректним JSON. | Виправте запит |
| 401 |
unauthorized
invalid_token
|
Див. «Автентифікація». | Виправте токен |
| 402 |
insufficient_balance
|
Баланс не покриває один запит. | Після поповнення |
| 408 |
search_timeout
|
Пошук не завершився за 90 секунд. | Так |
| 409 |
idempotency_in_progress
idempotency_replay_unavailable
|
Див. «Безпечні повторні запити». | Залежить від коду |
| 413 |
payload_too_large
|
Тіло перевищує 16 КБ. | Виправте запит |
| 422 |
invalid_request
country_unavailable
|
Поле не пройшло валідацію (яке саме, вказано в повідомленні) або ринок не відкрито. | Виправте запит |
| 424 |
proxy_unavailable
captcha_failed
search_failed
|
Живий пошук не вдався на нашому боці. | Так, після короткої паузи |
| 503 |
busy
billing_unavailable
configuration_error
|
Сервіс завантажений або тимчасово недоступний. | Так, зі зростанням інтервалу |
408, 424 чи 5xx не тарифікується. Повторюйте 408, 424 і 503 з експоненційною затримкою, наприклад через 5, 15 і 45 секунд, а не в щільному циклі, і з новим Idempotency-Key: той самий ключ до 15 хвилин повертає ту саму помилку замість нового пошуку.Безпечні повторні запити
Необов’язково. Потрібно лише тоді, коли ваш клієнт може повторити запит, який обірвався.
Живий пошук триває до 90 секунд. Якщо за цей час з’єднання розірветься, ви не знатимете, чи пошук завершився і чи його тарифіковано. Заголовок Idempotency-Key дає змогу повторити запит, не заплативши двічі:
- Той самий ключ: якщо перший пошук завершився, ви знову отримаєте ту саму відповідь із заголовком
Idempotent-Replayed: trueі без другого списання; пошук, що завершився збоєм, повертає ту саму помилку. Якщо він ще виконується, повторний запит дочекається його. Повторюйте ключ лише тоді, коли ви не отримали результат, після обриву з’єднання чи тайм-ауту клієнта; після408,424чи5xxнадсилайте новий ключ. - Пошук визначає лише ключ: повтор з іншим тілом отримує відповідь першого запиту, тож новий пошук надсилайте з новим ключем.
- Результати зберігаються до 15 хвилин. Після цього повтор зі старим ключем повертає
409 idempotency_replay_unavailable; надішліть новий запит із новим ключем. - Без заголовка кожен запит новий і тарифікується окремо.
curl -X POST https://api.serper.live/v1/search \
-H "Authorization: Bearer sl_live_YOUR_TOKEN" \
-H "Idempotency-Key: 0199860b-2f4e-7a1c-9b3d-5e6f70819a2b" \
-H "Content-Type: application/json" \
-d '{"query":"best coffee shops","country":"AE","limit":10}'
const response = await fetch('https://api.serper.live/v1/search', {
method: 'POST',
headers: {
Authorization: 'Bearer sl_live_YOUR_TOKEN',
'Idempotency-Key': '0199860b-2f4e-7a1c-9b3d-5e6f70819a2b',
'Content-Type': 'application/json',
},
body: JSON.stringify({ query: 'best coffee shops', country: 'AE', limit: 10 }),
signal: AbortSignal.timeout(100000),
});
const result = await response.json();
import requests
response = requests.post(
"https://api.serper.live/v1/search",
headers={
"Authorization": "Bearer sl_live_YOUR_TOKEN",
"Idempotency-Key": "0199860b-2f4e-7a1c-9b3d-5e6f70819a2b",
},
json={"query": "best coffee shops", "country": "AE", "limit": 10},
timeout=100,
)
result = response.json()
<?php
$context = stream_context_create(['http' => [
'method' => 'POST',
'header' => "Authorization: Bearer sl_live_YOUR_TOKEN\r\nIdempotency-Key: 0199860b-2f4e-7a1c-9b3d-5e6f70819a2b\r\nContent-Type: application/json",
'content' => json_encode(['query' => 'best coffee shops', 'country' => 'AE', 'limit' => 10]),
'timeout' => 100,
]]);
$result = json_decode(file_get_contents('https://api.serper.live/v1/search', false, $context), true);
Ключ — будь-який рядок із 8–128 символів набору A-Za-z0-9._:-. Найпростіший вибір — новий UUID на кожен логічний запит; він має лишатися однаковим для всіх повторів цього запиту.
Обмеження і корисне
query2–120 символів,limit1–100, тіло запиту до 16 КБ.- Пошуки виконуються паралельно в межах потужності сервісу; понад неї ви отримаєте
503 busy. Повторюйте зі зростанням інтервалу. - Зазвичай 2–3 секунди на 10 результатів і близько секунди на кожну наступну сторінку; пошук, що триває понад 90 секунд, завершується
408 search_timeout. Установіть тайм-аут клієнта щонайменше 100 секунд. - Кожна відповідь має заголовок
X-Request-Id. Зберігайте його в логах поруч ізrequestIdз тіла. - Нічого не кешується: два однакові запити — це два живі пошуки і два списання. Якщо повторно використовуєте результати, кешуйте на своєму боці.
Як знайти позицію домену
API повертає органічні результати до limit, типово топ-10; знайти в ньому один сайт — це цикл по organic[] у вашому коді. Порівняйте domain кожного елемента з хостом, який ви відстежуєте: position першого збігу і є позицією для цього ключового слова, країни й пристрою. Приклад нижче робить саме це, з тим самим запитом у curl, JavaScript і Python.
Три правила роблять порівняння чесним:
- Нормалізуйте перед порівнянням: переведіть обидві сторони в нижній регістр, відкиньте початкове
www.і порівнюйте лише хости, а не повні URL. - Вирішіть, як рахувати субдомени.
blog.example.com— інший хост, ніжexample.com; для суворого трекера порівнюйте точний хост, а для трекера на рівні бренду вважайте тим самим сайтом будь-який хост, що закінчується на.example.com. - Відсутність збігу означає, що в цій перевірці сайт поза запитаним діапазоном, а не помилку. Так це й зберігайте: запит повертає щонайбільше
limitорганічних результатів, тож піднімітьlimit(до 100, одна ціна за кожні 10), якщо відстежуєте позиції глибше за топ-10.
curl -s -X POST https://api.serper.live/v1/search \
-H "Authorization: Bearer sl_live_YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query":"best coffee shops","country":"AE","device":"desktop"}' \
| jq '.organic[] | select(.domain == "example.com") | .position'
const response = await fetch('https://api.serper.live/v1/search', {
method: 'POST',
headers: {
Authorization: 'Bearer sl_live_YOUR_TOKEN',
'Content-Type': 'application/json',
},
body: JSON.stringify({ query: 'best coffee shops', country: 'AE', device: 'desktop' }),
signal: AbortSignal.timeout(100000),
});
const { organic } = await response.json();
const hit = organic.find(row => row.domain === 'example.com');
console.log(hit ? hit.position : 'outside the top 10');
import requests
response = requests.post(
"https://api.serper.live/v1/search",
headers={"Authorization": "Bearer sl_live_YOUR_TOKEN"},
json={"query": "best coffee shops", "country": "AE", "device": "desktop"},
timeout=100,
)
organic = response.json()["organic"]
position = next((row["position"] for row in organic if row["domain"] == "example.com"), None)
print(position or "outside the top 10")
<?php
$context = stream_context_create(['http' => [
'method' => 'POST',
'header' => "Authorization: Bearer sl_live_YOUR_TOKEN\r\nContent-Type: application/json",
'content' => json_encode(['query' => 'best coffee shops', 'country' => 'AE', 'device' => 'desktop']),
'timeout' => 100,
]]);
$result = json_decode(file_get_contents('https://api.serper.live/v1/search', false, $context), true);
$hit = array_find($result['organic'], fn(array $row) => $row['domain'] === 'example.com');
echo $hit['position'] ?? 'outside the top 10';
Сторінка API відстеження позицій описує повний цикл трекера: списки ключових слів, розклад, зберігання і вартість місяця перевірок.
Для AI-агентів (MCP)
MCP-сервер Serper.live дає AI-агентам — Claude, OpenAI Codex, Cursor, VS Code Copilot — живий пошук Google через цей API. Він запускається локально через npx, потребує Node.js 20 або новішого й автентифікується тим самим API-токеном у змінній середовища SERPER_LIVE_TOKEN; пошуки тарифікуються так само, як POST /v1/search.
google_search: живі органічні результати для ключового слова, країни, мови й пристрою, до 100 за виклик.domain_position: на якій позиції домен за ключовим словом; піддомен рахується як домен, а якщо сайт трапляється кілька разів, повертається кожна позиція.list_countries: відкриті ринки й типова мова Google для кожного; безкоштовно, без токена.
claude mcp add serper-live -e SERPER_LIVE_TOKEN=sl_live_YOUR_TOKEN -- npx -y @serper-live/mcp
{
"mcpServers": {
"serper-live": {
"command": "npx",
"args": [
"-y",
"@serper-live/mcp"
],
"env": {
"SERPER_LIVE_TOKEN": "sl_live_YOUR_TOKEN"
}
}
}
}
{
"inputs": [
{
"type": "promptString",
"id": "serper-live-token",
"description": "Serper.live API token",
"password": true
}
],
"servers": {
"serper-live": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@serper-live/mcp"
],
"env": {
"SERPER_LIVE_TOKEN": "${input:serper-live-token}"
}
}
}
}
[mcp_servers.serper-live]
command = "npx"
args = ["-y", "@serper-live/mcp"]
[mcp_servers.serper-live.env]
SERPER_LIVE_TOKEN = "sl_live_YOUR_TOKEN"
Пакет — @serper-live/mcp в npm і io.github.serper-live/serper-live-mcp в офіційному MCP Registry; README в репозиторії описує налаштування для інших клієнтів. Claude Desktop також встановлює його в один клік із бандла .mcpb і сам запитує токен, без Node.js.