# Rampify Seo Audit Skill

> Free Claude Skill for comprehensive single-page SEO audits

- **Type:** MCP server
- **Install:** `agentstack add mcp-rampify-dev-rampify-seo-audit-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [rampify-dev](https://agentstack.voostack.com/s/rampify-dev)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [rampify-dev](https://github.com/rampify-dev)
- **Source:** https://github.com/rampify-dev/rampify-seo-audit-skill
- **Website:** https://rampify.dev

## Install

```sh
agentstack add mcp-rampify-dev-rampify-seo-audit-skill
```

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

## About

# Rampify SEO Audit Skill

A free, open-source Claude Skill for comprehensive single-page SEO audits. Built by the [Rampify](https://www.rampify.dev) team as a gift to the Claude Code/Cursor community.

## What It Does

Performs instant SEO audits on individual pages, checking:

- **Meta Tags** - Title, description, Open Graph, Twitter Cards
- **Schema.org** - Structured data validation (JSON-LD, Microdata, RDFa)
- **Heading Structure** - H1-H6 hierarchy and optimization
- **Images** - Alt text, file sizes, lazy loading
- **Links** - Internal/external link analysis
- **Content Quality** - Word count, readability, keyword density
- **Mobile** - Responsiveness indicators
- **Performance** - Page speed signals

## Installation

### Prerequisites

- [Claude Code](https://claude.ai/code) or [Cursor](https://cursor.sh) installed
- Node.js 18+ (for local development only)

### Quick Install

```bash
# Clone the repository
git clone https://github.com/rampify-dev/rampify-seo-audit-skill.git
cd rampify-seo-audit-skill

# Install dependencies (if using TypeScript version)
npm install
```

### Add to Claude Code

1. Open Claude Code settings
2. Navigate to Skills section
3. Click "Add Skill from Directory"
4. Select the `rampify-seo-audit-skill` folder

### Add to Cursor

1. Open Cursor settings
2. Go to Skills configuration
3. Click "Import Skill"
4. Choose the cloned directory

## Usage

Once installed, the Skill activates automatically when you work with web pages.

### Basic Audit

Open any HTML, JSX, MDX, or similar file and ask:

```
"Audit this page for SEO"
"Check SEO issues on this page"
"What SEO problems does this have?"
```

### Specific Checks

Request targeted analysis:

```
"Check the meta tags"
"Validate the schema markup"
"Analyze heading structure"
"Check image optimization"
```

### Example Output

```
SEO Audit Report: /blog/how-to-use-claude-for-seo

Critical Issues (2):
  ❌ Missing meta description
  ❌ Invalid Article schema: missing "datePublished" property

Warnings (4):
  ⚠️  Title too short (42 chars, recommend 50-60)
  ⚠️  No alt text on 3 images
  ⚠️  H2 heading appears before H1
  ⚠️  No canonical tag specified

Info (2):
  ℹ️  Word count: 847 (good for blog post)
  ℹ️  Internal links: 5, External links: 2

Recommendations:
  1. Add meta description (150-160 chars, include target keyword)
  2. Fix Article schema:
     Add: "datePublished": "2025-12-05T10:30:00Z"
  3. Extend title to 50-60 chars: "How to Use Claude for SEO Audits | Developer Guide"
  4. Add alt text to images: /images/claude-seo-1.png, /images/claude-seo-2.png
  5. Move H1 above first H2
  6. Add canonical: 

Priority Order:
  1. Fix schema (impacts rich results)
  2. Add meta description (impacts CTR)
  3. Fix title length (impacts CTR)
  4. Add canonical tag (prevents duplicate content)
  5. Fix heading structure (minor UX/SEO impact)
```

## What This Skill Does NOT Do

This Skill is designed for **single-page audits**. It does not:

- Track issues across multiple pages
- Monitor for regressions over time
- Integrate with Google Search Console
- Prioritize by traffic impact
- Remember previous audits
- Run automatically on deployment
- Alert when new issues appear

**When you outgrow this Skill**, check out [UPGRADE.md](UPGRADE.md) for guidance on systematic SEO intelligence.

## Customization

### Adjust Severity Levels

Edit `config/rules.json` to change what counts as critical vs warning:

```jsonc
{
  // Severity levels: critical, warning, info
  "meta_description_missing": "critical",  // Change to "warning" if desired
  "title_too_short": "warning",
  "alt_text_missing": "info"
}
```

### Add Custom Checks

Create new rules in `src/checks/`:

```typescript
// src/checks/custom-check.ts
export function checkCustomRule(page: Page): Issue[] {
  const issues: Issue[] = [];

  // Your custom logic here

  return issues;
}
```

### Modify Output Format

Update `src/formatter.ts` to change how results are displayed.

## Examples

See `examples/` directory for sample pages and their audit results:

- `examples/blog-post/` - Blog post with common issues
- `examples/product-page/` - E-commerce product page
- `examples/landing-page/` - Marketing landing page
- `examples/documentation/` - Technical documentation

## Contributing

Contributions welcome! This is a community resource.

### Adding New Checks

1. Fork the repository
2. Create a new check in `src/checks/`
3. Add tests in `src/checks/__tests__/`
4. Update `README.md` with the new check
5. Submit a pull request

### Reporting Issues

Found a bug or false positive? [Open an issue](https://github.com/rampify-dev/rampify-seo-audit-skill/issues)

## Architecture

```
rampify-seo-audit-skill/
├── src/
│   ├── index.ts              # Main Skill entry point
│   ├── checks/               # Individual SEO checks
│   │   ├── meta-tags.ts
│   │   ├── schema.ts
│   │   ├── headings.ts
│   │   ├── images.ts
│   │   ├── links.ts
│   │   └── content.ts
│   ├── utils/
│   │   ├── parser.ts         # HTML/JSX parsing
│   │   ├── validator.ts      # Schema validation
│   │   └── scorer.ts         # Issue severity scoring
│   └── formatter.ts          # Output formatting
├── config/
│   └── rules.json            # Configurable rules
├── examples/
│   ├── blog-post/
│   ├── product-page/
│   └── landing-page/
├── __tests__/
│   └── checks/
├── skill.json                # Claude Skill definition
├── package.json
├── tsconfig.json
├── README.md
├── UPGRADE.md
├── CONTRIBUTING.md
└── LICENSE
```

## When to Upgrade

**This Skill is perfect for:**
- Learning SEO best practices
- Auditing pages during development
- Spot-checking specific pages
- Pre-publish validation

**You'll need more when:**
- Managing 20+ pages
- Deploying changes frequently
- Working with multiple sites
- Needing historical tracking
- Wanting automated monitoring

**See [UPGRADE.md](UPGRADE.md) for your options.**

## License

MIT License - Use it however you want!

## Credits

Built with ❤️ by the [Rampify](https://www.rampify.dev) team.

**Want systematic SEO intelligence?**
- [Rampify MCP Server](https://www.rampify.dev/docs/mcp-server) - Site-wide audits in your editor
- [Rampify Platform](https://www.rampify.dev) - Full monitoring with dashboard

## Support

- **Issues**: [GitHub Issues](https://github.com/rampify-dev/rampify-seo-audit-skill/issues)
- **Discussions**: [GitHub Discussions](https://github.com/rampify-dev/rampify-seo-audit-skill/discussions)
- **Documentation**: [Rampify Docs](https://www.rampify.dev/docs)
- **Community**: [Join our Discord](https://discord.gg/rampify)

## Source & license

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

- **Author:** [rampify-dev](https://github.com/rampify-dev)
- **Source:** [rampify-dev/rampify-seo-audit-skill](https://github.com/rampify-dev/rampify-seo-audit-skill)
- **License:** MIT
- **Homepage:** https://rampify.dev

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/mcp-rampify-dev-rampify-seo-audit-skill
- Seller: https://agentstack.voostack.com/s/rampify-dev
- 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%.