Skip to content

INSTALLATION.md

Latest commit

 

History

History
159 lines (108 loc) · 3.11 KB

INSTALLATION.md

File metadata and controls

159 lines (108 loc) · 3.11 KB

Installation Guide

Prerequisites

  • Python 3.10+ with pip
  • Git for cloning the repository
  • Claude Code CLI installed and configured

Optional:

  • Playwright for screenshot capabilities

Quick Install

Unix/macOS/Linux

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.ps1 | iex

Manual Installation

  1. Clone the repository
git clone https://github.com/AgriciDaniel/claude-seo.git
cd claude-seo
  1. Run the installer
./install.sh
  1. Install Python dependencies (if not done automatically)

The installer creates a venv at ~/.claude/skills/seo/.venv/. If that fails, install manually:

# Option A: Use the venv
~/.claude/skills/seo/.venv/bin/pip install -r ~/.claude/skills/seo/requirements.txt

# Option B: User-level install
pip install --user -r ~/.claude/skills/seo/requirements.txt
  1. Install Playwright browsers (optional, for visual analysis)
pip install playwright
playwright install chromium

Playwright is optional. Without it, visual analysis uses WebFetch as a fallback.

Installation Paths

The installer copies files to:

Component Path
Main skill ~/.claude/skills/seo/
Sub-skills ~/.claude/skills/seo-*/
Subagents ~/.claude/agents/seo-*.md

Verify Installation

  1. Start Claude Code:
claude
  1. Check that the skill is loaded:
/seo

You should see a help message or prompt for a URL.

Uninstallation

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/uninstall.sh | bash

Or manually:

rm -rf ~/.claude/skills/seo
rm -rf ~/.claude/skills/seo-audit
rm -rf ~/.claude/skills/seo-competitor-pages
rm -rf ~/.claude/skills/seo-content
rm -rf ~/.claude/skills/seo-geo
rm -rf ~/.claude/skills/seo-hreflang
rm -rf ~/.claude/skills/seo-images
rm -rf ~/.claude/skills/seo-page
rm -rf ~/.claude/skills/seo-plan
rm -rf ~/.claude/skills/seo-programmatic
rm -rf ~/.claude/skills/seo-schema
rm -rf ~/.claude/skills/seo-sitemap
rm -rf ~/.claude/skills/seo-technical
rm -f ~/.claude/agents/seo-*.md

Upgrading

To upgrade to the latest version:

# Uninstall current version
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/uninstall.sh | bash

# Install new version
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh | bash

Troubleshooting

"Skill not found" error

Ensure the skill is installed in the correct location:

ls ~/.claude/skills/seo/SKILL.md

If the file doesn't exist, re-run the installer.

Python dependency errors

Install dependencies manually:

pip install beautifulsoup4 requests lxml playwright Pillow urllib3 validators

Playwright screenshot errors

Install Chromium browser:

playwright install chromium

Permission errors on Unix

Make sure scripts are executable:

chmod +x ~/.claude/skills/seo/scripts/*.py