seo-visual

seo-visual is an agent for Claude Code from AgriciDaniel/claude-seo. It costs 25 tokens per session (512 once invoked), scanned A, original, MIT.

A browser-based visual checker that captures page screenshots and reviews what visitors see on desktop and mobile. It uses Playwright, a tool for controlling a web browser automatically.

In plain words
What is it for?
Use it to test responsive layouts, inspect the content visible before scrolling, check that headings and main buttons appear, and spot loading or navigation issues.
Why use it?
It helps find layout problems that code or text checks can miss, such as overlapping elements, missing content, and pages that do not adapt to smaller screens.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter.

Part of the claude-seo plugin — 31 skills, 18 agents, 1 hook shipped together

About the project

Claude SEO is an open-source Claude Code plugin that runs specialized agents and skills to audit websites across technical SEO, content quality, structured data, AI-search optimization, local and e-commerce SEO, and international SEO. SEO practitioners use it to produce prioritized recommendations based on primary-source guidance, with optional extensions for external data and crawling.

AgriciDaniel/claude-seo · 16,398 stars · on GitHub · claude-seo.md

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/agricidaniel/claude-seo/seo-visual
Clone the repo
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo

Made for: Claude Code.

Or install claude-seo, the plugin that ships this one along with the rest of its 31 skills, 18 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for seo-visual

README.md
[![agentmods](https://agentmods.dev/badge/agents/agricidaniel/claude-seo/seo-visual.svg)](https://agentmods.dev/agents/agricidaniel/claude-seo/seo-visual)
Your own site
<a href="https://agentmods.dev/agents/agricidaniel/claude-seo/seo-visual"><img src="https://agentmods.dev/badge/agents/agricidaniel/claude-seo/seo-visual.svg" alt="Measured on agentmods" height="20"></a>
Per session 25 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 512 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00025 $0.00512
Opus 5 $0.00013 $0.00256
Sonnet 5 $0.00005 $0.00102
Haiku 4.5 $0.00003 $0.00051

Measured 7d ago against content hash 472d9f1c3e51, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

seo-visual scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/seo-visual.md · 81 lines

How it starts

The opening of the file, as written. The whole thing — 81 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are a Visual Analysis specialist using Playwright for browser automation.

Prerequisites

Before capturing screenshots, ensure Playwright and Chromium are installed:

pip install playwright && playwright install chromium

When Analyzing Pages

  1. Capture desktop screenshot (1920x1080)
  2. Capture mobile screenshot (375x812, iPhone viewport)
  3. Analyze above-the-fold content: is the primary CTA visible?
  4. Check for visual layout issues, overlapping elements
  5. Verify mobile responsiveness

Screenshot Script

Use the managed screenshot and renderer commands for browser automation:

claude-seo run capture_screenshot.py URL --all --output screenshots/
claude-seo run render_page.py URL --mode auto --a11y-tree --json

Viewports to Test

Device Width Height
Desktop 1920 1080
Laptop 1366 768
Tablet 768 1024
Mobile 375 812

Visual Checks

Above-the-Fold Analysis

  • Primary heading (H1) visible without scrolling
  • Main CTA visible without scrolling
  • Hero image/content loading properly
  • No layout shifts on load

Mobile Responsiveness

  • Navigation accessible (hamburger menu or visible)
  • Touch targets at least 48x48px
  • No horizontal scroll
  • Text readable without zooming (16px+ base font)

Visual Issues

  • Overlapping elements
  • Text cut off or overflow
  • Images not scaling properly
  • Broken layout at different widths

Output Format

Provide:

  • Screenshots saved to screenshots/ directory
  • Visual analysis summary
  • Mobile responsiveness assessment
  • Above-the-fold content evaluation
  • Specific issues with element locations

Persistence Contract

If output_dir is provided by the audit orchestrator, write:

  • output_dir/screenshots/desktop.png and output_dir/screenshots/mobile.png when capture succeeds
  • output_dir/findings/visual.md: above-the-fold, mobile, layout, and accessibility-tree findings
  • Structured JSON-compatible findings for audit-data.json under the Visual category

Read the full file on GitHub · 81 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 81 lines · 25 tokens per session scan A 472d9f1c3e51

Subscribe to this mod's changes

seo-visual is an agent published in the GitHub repository AgriciDaniel/claude-seo (16,398 stars, last pushed 11d ago), licensed MIT. It adds 25 tokens to every session and 512 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

blog-researcher

Research specialist for blog content. Finds current statistics (2025-2026), verifies sources against tier 1-3 quality standards, discovers Pixabay/Unsplash/Pexels images, and identifies competitive content gaps. Invoked for statistic research, image discovery, and competitive analysis tasks during blog writing…

AgriciDaniel/claude-blog · 66 tokens

blog-reviewer

Quality assessment specialist for blog posts. Runs the full 5-category, 100-point scoring system, identifies issues by severity, checks for AI editorial style diagnostics, validates source quality, and flags unsupported factual or first-hand claims. Invoked for quality review tasks during blog workflows.

AgriciDaniel/claude-blog · 59 tokens

blog-writer

Content generation specialist for blog posts. Writes optimized articles with answer-first formatting, proper heading hierarchy, sourced statistics, and natural readability. Follows the 6 pillars of dual optimization. Invoked for content writing and rewriting tasks during blog workflows.

AgriciDaniel/claude-blog · 52 tokens

claude-blog-secretary

The owner's dedicated Claude Blog agent, grounded in the Claude Blog Brain at . Use for any blog-content work - writing and rewriting for Google rankings and AI citations, E-E-A-T, GEO and AEO, schema, topic clusters, briefs and outlines, editorial strategy, multilingual publishing, the FLOW framework, factchecking…

AgriciDaniel/claude-blog · 0 tokens

blog-cluster-curator

Topic Clusters curator for the Claude Blog Brain. Maintains and answers from the Topic Clusters theme of the brain, grounded in the vault and its dated sources. Advisory and read-only. Use for semantic topic clusters, hub-and-spoke architecture, internal linking, and cannibalization.

AgriciDaniel/claude-blog · 64 tokens

blog-data-curator

Data Integrations curator for the Claude Blog Brain. Maintains and answers from the Data Integrations theme of the brain, grounded in the vault and its dated sources. Advisory and read-only. Use for GSC, GA4, PageSpeed, CrUX, and NLP integrations plus content-decay detection.

AgriciDaniel/claude-blog · 66 tokens