# Seo Google

> Google SEO APIs: public PSI/CrUX plus optional Search Console Search Analytics and GA4 organic sessions from ~/.config/seoskillsai/gsc_ga4.json.

- **Type:** Skill
- **Install:** `agentstack add skill-seoskillsai-seo-skills-ai-seo-google`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [seoskillsai](https://agentstack.voostack.com/s/seoskillsai)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [seoskillsai](https://github.com/seoskillsai)
- **Source:** https://github.com/seoskillsai/seo-skills-ai/tree/main/skills/seo-google
- **Website:** https://seoskillsai.com

## Install

```sh
agentstack add skill-seoskillsai-seo-skills-ai-seo-google
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Google SEO APIs & Real User Metrics

PageSpeed Insights and CrUX work without a user OAuth token. Search Console Search Analytics and GA4 organic sessions require a **local** OAuth client.

Create `~/.config/seoskillsai/gsc_ga4.json` (mode `0o600`) and run `python scripts/google_installed_app.py --setup`. Scopes: `webmasters.readonly`, `analytics.readonly`.

Until that file exists, `python scripts/gsc_query.py` and `python scripts/ga4_report.py` return `{"status": "UNAVAILABLE"}` with **no invented metrics**. MCP tools `seo_gsc` / `seo_ga4` do the same.

Do not wire this public plugin to any private analytics identity database.

---

## Credential gate

| Surface | Required local data | If missing |
| :--- | :--- | :--- |
| PSI / CrUX | none | live public APIs or UNAVAILABLE (never fake scores) |
| GSC Search Analytics | OAuth refresh token | `UNAVAILABLE` |
| GA4 organic sessions | OAuth refresh token **and** `ga4_property_id` | `UNAVAILABLE` |

---

## CLI

```bash
python scripts/google_installed_app.py --setup
python scripts/google_auth.py --status
python scripts/gsc_query.py --site "https://example.com" --filter striking-distance
python scripts/ga4_report.py --days 28
python scripts/crux_history.py --url "https://example.com"
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [seoskillsai](https://github.com/seoskillsai)
- **Source:** [seoskillsai/seo-skills-ai](https://github.com/seoskillsai/seo-skills-ai)
- **License:** MIT
- **Homepage:** https://seoskillsai.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-seoskillsai-seo-skills-ai-seo-google
- Seller: https://agentstack.voostack.com/s/seoskillsai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.