# Seo Check

> Audit SEO, Open Graph, responsive design. Checks meta tags, OG image, robots.txt, sitemap, structured data, and mobile rendering.

- **Type:** Skill
- **Install:** `agentstack add skill-otomata-tech-claude-skills-seo-check`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [otomata-tech](https://agentstack.voostack.com/s/otomata-tech)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [otomata-tech](https://github.com/otomata-tech)
- **Source:** https://github.com/otomata-tech/claude-skills/tree/master/skills/seo-check
- **Website:** https://otomata-tech.github.io/claude-skills/

## Install

```sh
agentstack add skill-otomata-tech-claude-skills-seo-check
```

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

## About

# SEO & Responsive Audit

Audit a web project's SEO metadata and responsive rendering from source code. Fix issues found.

## Input

- Work from the current project directory (cwd)
- An optional URL argument for the responsive check (screenshots). If not provided, infer the production URL from CLAUDE.md, config files, or env vars.

## Step 0: Locate Files

Find the HTML entry point and static assets:
1. Search for `index.html` — common locations: `./index.html`, `public/index.html`, `frontend/index.html`, `src/index.html`
2. Find the static/public assets directory (where `robots.txt`, `sitemap.xml`, OG images live): `public/`, `frontend/public/`, `static/`
3. Identify the production domain from CLAUDE.md, package.json homepage, env files, or nginx config

## 1. Meta Tags Audit

Read the HTML `` from the source `index.html` and check:

| Check | Optimal |
|-------|---------|
| `` | 50–60 characters, includes brand + value prop |
| `` | 120–160 characters, actionable |
| `` | Present, absolute URL |
| `` | Present |
| `` | Present |

Report: present/missing/too short/too long for each.

## 2. Open Graph Audit

Check these `` tags in `index.html`:

| Tag | Required |
|-----|----------|
| `og:title` | Yes — 50–60 chars |
| `og:description` | Yes — under 200 chars |
| `og:image` | Yes — URL to image |
| `og:image:width` | Yes — 1200 |
| `og:image:height` | Yes — 630 |
| `og:url` | Yes — canonical URL |
| `og:type` | Yes — `website` or `article` |
| `og:site_name` | Recommended |

### OG Image Validation

If `og:image` references an image file:
1. Find the local file in the public/static assets directory
2. Read the image to check dimensions (should be 1200×630) and inspect visually
3. Check file size ` in `index.html`:
- Present? Parse and validate JSON
- Has `@type` — `SoftwareApplication`, `WebSite`, `Organization`, etc.
- Has `name`, `url`, `description`
- Schema matches the actual product/site

## 5. Crawler Files

Look for these files in the static/public assets directory:

### robots.txt
- Exists?
- Has `Sitemap:` directive?
- Blocks auth/api/admin routes?
- Allows public pages?

### sitemap.xml
- Exists?
- Valid XML?
- Lists all public pages?
- No authenticated/private pages included?

## 6. Responsive Design Check

Use `o-browser` (BrowserClient) to take screenshots of the production URL at multiple viewports:

```python
from o_browser import BrowserClient

viewports = [
    ("mobile", 375, 812),     # iPhone 13
    ("tablet", 768, 1024),    # iPad
    ("desktop", 1440, 900),   # Standard desktop
]

async with BrowserClient(headless=True) as browser:
    for name, w, h in viewports:
        await browser.page.set_viewport_size({"width": w, "height": h})
        await browser.goto(url)
        await browser.page.wait_for_load_state("networkidle")
        await browser.screenshot(f"/tmp/responsive-{name}.png")
```

Then read each screenshot and check:
- **Mobile**: no horizontal overflow, text readable, touch targets ≥ 44px, navigation usable
- **Tablet**: layout adapts, no wasted space, images scale
- **Desktop**: full layout, no broken sections

## 7. Output

### Report Format

```
## SEO Audit: 

### Meta Tags
- ✅ title: "..." (XX chars)
- ❌ description: missing
- ...

### Open Graph
- ✅ og:title: "..."
- ⚠️ og:image: exists but no headline text
- ...

### Twitter Card
- ✅ All tags present

### Structured Data
- ✅ JSON-LD SoftwareApplication

### Crawler Files
- ✅ robots.txt
- ❌ sitemap.xml: missing

### Responsive
- ✅ Mobile: [screenshot]
- ⚠️ Tablet: horizontal overflow on hero section
- ✅ Desktop: OK

### Issues to Fix
1. [priority] description
2. ...
```

### After Reporting

- Ask the user which issues to fix
- Fix them directly in source code (edit HTML, generate images, create files)
- For OG image generation, use Python PIL to create/modify images with text overlay
- For responsive issues, edit CSS/components in the project
- Re-run affected checks after fixes

## Source & license

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

- **Author:** [otomata-tech](https://github.com/otomata-tech)
- **Source:** [otomata-tech/claude-skills](https://github.com/otomata-tech/claude-skills)
- **License:** MIT
- **Homepage:** https://otomata-tech.github.io/claude-skills/

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-otomata-tech-claude-skills-seo-check
- Seller: https://agentstack.voostack.com/s/otomata-tech
- 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%.