Skip to content

INSTALLATION.md

Latest commit

 

History

History
174 lines (115 loc) · 3.66 KB

INSTALLATION.md

File metadata and controls

174 lines (115 loc) · 3.66 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

Plugin Install (Claude Code 1.0.33+)

The recommended path. Inside Claude Code:

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-seo

Manual Install (Unix, macOS, Linux)

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

Review-then-run alternative:

curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh > install.sh
cat install.sh        # review
bash install.sh       # run when satisfied
rm install.sh

Manual Install (Windows, PowerShell)

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1

The Windows path uses git clone rather than irm | iex because Claude Code's own security guardrails flag piped remote-script execution. Inspect install.ps1 before running.

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

If installed as a plugin:

/plugin uninstall claude-seo@agricidaniel-seo
/plugin marketplace remove AgriciDaniel/claude-seo

If installed manually, run the uninstaller from a fresh clone:

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/uninstall.sh

uninstall.sh removes all installed sub-skills, sub-agents, and the plugin's MCP entries from ~/.claude/settings.json. Do not maintain a hand-coded rm list. The shipped uninstaller is the canonical source.

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