Google SERP
Use this skill for Google SERP research, search result collection, competitive intelligence, trend monitoring, local business lookups, and shopping or scholar analysis. It is the broad Google-facing skill for tasks that start from a keyword, a place, a domain, or a topic and need structured Google result data.
When To Use It
- The user wants Google web search, news search, image search, video search, or mobile SERP output for a keyword.
- The task is about Google Maps, Local, Shopping, Trends, Scholar, Finance, Hotels, Lens, Jobs, or AI result surfaces.
- The user can provide filters such as
query, country, language, domain, page, geo, or a Google Maps place identifier.
- The user needs API-backed Google result data for research, monitoring, ranking checks, or reporting instead of a freeform answer.
Representative Operations
search: Search SERP — Pull standard Google web results for keyword research and ranking checks.
mapsSearch: Maps Search — Find Google Maps business results and local pack data for a query and location.
TrendsSearch: Trends Search — Inspect time-series search interest and related trend signals.
ScholarSearch: Scholar Search — Query academic search results and citation-oriented records.
shoppingSearch: Shopping Search — Collect product listings, merchants, and pricing signals from Google Shopping.
Request Pattern
- 31 read-only
GET operations are available in this skill.
- Common inputs are
query, country, domain, language, geo, page, html, and feature-specific identifiers.
- Most operations are query-only; none require a request body.
- Prefer the narrowest Google vertical that matches the task instead of using generic search for everything.
How To Work
- Read
generated/operations.md before choosing an endpoint.
- Start with one of these operations when it matches the user's request:
search, mapsSearch, TrendsSearch, ScholarSearch, shoppingSearch.
- Pick the smallest matching operation instead of guessing.
- Ask the user for any missing required parameter. Do not invent values.
- Call the helper with:
node {baseDir}/bin/run.mjs --operation "<operation-id>" --api-key "$JUST_SERP_API_KEY" --params-json '{"key":"value"}'
Environment
- Required:
JUST_SERP_API_KEY
- This skill uses
JUST_SERP_API_KEY only for authenticated Just Serp API requests.
- Keep
JUST_SERP_API_KEY private. Do not paste it into chat messages, screenshots, or logs.
- Project site: Just Serp API.
- Authentication details: Just Serp API Docs.
Output Rules
- Lead with the Google surface you used and the exact query or filters applied.
- For SERP-style responses, summarize the top result patterns before raw JSON.
- For Maps, Shopping, Scholar, or Trends requests, highlight the entity, metric, or ranking signals most relevant to the user's decision.
- If multiple Google verticals could answer the task, explain why the chosen endpoint was the best fit.
- If the backend errors, include the backend payload and the exact operation ID.