serp-extract

What problem does it solve?

This Skill solves the problem of reliably collecting and normalizing search engine results evidence for specific keywords, without turning evidence into strategy or analysis.

Core Features & Use Cases

• SERP evidence capture: Saves organic results and observed SERP features for requested keywords while preserving keyword order and provider facts.
• Provider-based raw + normalized outputs: Stores immutable raw provider payloads under project/audits/<slug>/sources/dataforseo/ as .raw.json and writes normalized extraction to project/audits/<slug>/report.yaml.
• Controlled provider modes: Uses DataForSEO standard flow by default, supports live/async when explicitly requested, and supports offline fixture mode for tests and development.
• Guardrails against invention: Produces empty evidence plus explicit limitations when results are missing, and blocks when required inputs like location/language/device cannot be determined.

Quick Start

Use the serp-extract skill to capture SERP evidence for the keywords "seo agêntico" and "seo com agentes" in Brazil for pt-BR desktop results, and write the normalized output to your project audits.