### Manual Installation Steps (Unix/macOS/Linux)

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/INSTALLATION.md

Steps for manual installation including cloning the repository, running the installer, and installing Python dependencies. This is an alternative to the plugin installation.

```bash
git clone https://github.com/AgriciDaniel/claude-seo.git
cd claude-seo
./install.sh
```

--------------------------------

### Local Development Setup for claude-seo

Source: https://github.com/agricidaniel/claude-seo/blob/main/CONTRIBUTING.md

Clone the repository and run the install script for local development.

```bash
git clone https://github.com/YOUR_USERNAME/claude-seo.git
cd claude-seo
bash install.sh
```

--------------------------------

### Review and Run Install Script (Unix/macOS/Linux)

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/INSTALLATION.md

Download the install script, review its contents, and then execute it for manual installation. This provides an extra layer of security by allowing inspection before running.

```bash
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
```

--------------------------------

### Install SE Ranking Extension

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/seranking/docs/SERANKING-SETUP.md

Run the appropriate installation script for your operating system. The installer will prompt for an API key and configure necessary files.

```bash
./extensions/seranking/install.sh
```

```powershell
.\extensions\seranking\install.ps1
```

--------------------------------

### Verify Installation and Dependencies

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/MIGRATION-v1-to-v2.md

After installation, verify that the new requirements are pinned correctly by running `pip install -r requirements.txt`. Ensure Playwright Chromium is installed for the `render_page` functionality by running `playwright install chromium`.

```bash
# Verify the new requirements pin landed
pip install -r requirements.txt

# Confirm Playwright Chromium is installed (used by render_page)
playwright install chromium
```

--------------------------------

### One-liner Install Claude SEO (Review then Run)

Source: https://github.com/agricidaniel/claude-seo/blob/main/README.md

A quick installation method using curl to download, review, and execute the install script. Remember to review the script before running it for security.

```bash
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh > install.sh
cat install.sh        # review before running
bash install.sh
rm install.sh
```

--------------------------------

### Manual Install Claude SEO (Unix/macOS/Linux)

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/INSTALLATION.md

Clone the repository and run the install script for manual installation on Unix-like systems. This method is suitable for older versions or specific environments.

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

--------------------------------

### Install DataForSEO Extension

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/dataforseo/README.md

Installation scripts for Unix/macOS/Linux and Windows environments to set up the extension and configure the MCP server.

```bash
git clone https://github.com/AgriciDaniel/claude-seo.git
cd claude-seo
./extensions/dataforseo/install.sh
```

```powershell
git clone https://github.com/AgriciDaniel/claude-seo.git
cd claude-seo
.\extensions\dataforseo\install.ps1
```

--------------------------------

### Start Claude Code

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/INSTALLATION.md

Command to start the Claude Code application. This is the first step to verify the installation.

```bash
claude
```

--------------------------------

### Install Python Dependencies (Manual)

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/INSTALLATION.md

Manually install Python dependencies using pip, either by activating the virtual environment created by the installer or using a user-level installation.

```bash
# 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
```

--------------------------------

### Manual Install Claude SEO (Windows/PowerShell)

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/INSTALLATION.md

Clone the repository and execute the PowerShell install script for manual installation on Windows. The script execution policy is bypassed for this installation.

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

--------------------------------

### Install Google Ads Python Library

Source: https://github.com/agricidaniel/claude-seo/blob/main/skills/seo-google/references/keyword-planner-api.md

Install the required google-ads library to interact with the API.

```bash
pip install google-ads
```

--------------------------------

### Install and Use DataForSEO Extension

Source: https://github.com/agricidaniel/claude-seo/blob/main/README.md

Installs the DataForSEO extension and demonstrates its usage for SERP analysis and AI mention tracking. Requires a DataForSEO account.

```bash
./extensions/dataforseo/install.sh   # requires DataForSEO account
/seo dataforseo serp best coffee shops
/seo dataforseo ai-mentions your brand
```

--------------------------------

### Install ImageMagick on Ubuntu/Pop!_OS

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/banana/docs/BANANA-SETUP.md

Install ImageMagick using apt for optional post-processing of generated images. This command installs the necessary package.

```bash
sudo apt install imagemagick
```

--------------------------------

### Google API Configuration File Example

Source: https://github.com/agricidaniel/claude-seo/blob/main/skills/seo-google/SKILL.md

Example structure for the Google API configuration file. Ensure 'service_account_path', 'api_key', 'default_property', and 'ga4_property_id' are correctly set.

```json
{
  "service_account_path": "/path/to/service_account.json",
  "api_key": "<GOOGLE_API_KEY>",
  "default_property": "sc-domain:example.com",
  "ga4_property_id": "properties/123456789"
}
```

--------------------------------

### Install Firecrawl Extension

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/firecrawl/README.md

Run the appropriate installation script for your operating system to configure the MCP server.

```bash
./extensions/firecrawl/install.sh
```

```powershell
.\extensions\firecrawl\install.ps1
```

--------------------------------

### Install Claude-SEO v2.0.0

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/MIGRATION-v1-to-v2.md

Use this command to download and execute the installation script for version 2.0.0. This is a convenience option; inspecting the script before running is recommended for security.

```bash
# Pull v2.0.0
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh | bash
```

--------------------------------

### Install Claude SEO Plugin

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/INSTALLATION.md

Use these commands to install the Claude SEO plugin from the marketplace within Claude Code. This is the recommended installation method for version 1.0.33+.

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

--------------------------------

### Install Banana Extension

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/banana/skills/seo-image-gen/SKILL.md

Install the banana extension by running the provided shell script. This is a prerequisite for using the image generation tools.

```bash
./extensions/banana/install.sh
```

--------------------------------

### Install Python Dependencies with --user

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/TROUBLESHOOTING.md

Install project dependencies using pip with the --user flag, which installs packages in the user's home directory. Use this if the venv does not exist.

```bash
pip install --user -r ~/.claude/skills/seo/requirements.txt
```

--------------------------------

### Re-run Installer Script

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/TROUBLESHOOTING.md

Download and execute the installation script for Claude-SEO. Use with caution as it involves running a remote script.

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

--------------------------------

### Install Profound Extension (Linux/macOS)

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/profound/docs/PROFOUND-SETUP.md

Run this script to install the Profound extension on Linux or macOS systems. It sets up the PROFOUND_API_KEY.

```bash
./extensions/profound/install.sh
```

--------------------------------

### Install DataForSEO Extension

Source: https://github.com/agricidaniel/claude-seo/blob/main/agents/seo-backlinks.md

If all free backlink sources fail during analysis, suggest the installation of the DataForSEO extension. This provides an alternative data source for backlink information.

```bash
./extensions/dataforseo/install.sh
```

--------------------------------

### Install Python using Windows Launcher

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/TROUBLESHOOTING.md

Use the Windows Python launcher 'py -3' to install requirements, especially if 'python' or 'pip' commands are not recognized or point to the wrong Python installation.

```bash
py -3 -m pip install -r requirements.txt
```

--------------------------------

### Install Bing Webmaster Extension (Bash)

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/bing-webmaster/docs/BING-WEBMASTER-SETUP.md

Run this script to install the extension using Bash. You will be prompted for API keys and host keys.

```bash
./extensions/bing-webmaster/install.sh
```

--------------------------------

### Install Claude SEO Plugin

Source: https://github.com/agricidaniel/claude-seo/blob/main/AGENTS.md

This script installs the Claude SEO plugin for Google Antigravity. Ensure you have bash and the necessary permissions.

```bash
bash install.sh
```

--------------------------------

### Install Ahrefs Extension (Windows PowerShell)

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/ahrefs/docs/AHREFS-SETUP.md

Execute this PowerShell script to install the Ahrefs extension on Windows. It performs similar setup steps as the Linux/macOS installer.

```powershell
.\extensions\ahrefs\install.ps1
```

--------------------------------

### Validate Banana Extension Setup

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/banana/docs/BANANA-SETUP.md

Run this Python script to validate the Banana Extension setup. Ensure Python 3 is installed and the script path is correct.

```bash
python3 ~/.claude/skills/seo-image-gen/scripts/validate_setup.py
```

--------------------------------

### Setup Backlink APIs

Source: https://github.com/agricidaniel/claude-seo/blob/main/skills/seo-backlinks/SKILL.md

Displays instructions for setting up free backlink APIs like Moz and Bing Webmaster.

```bash
/seo backlinks setup
```

--------------------------------

### Verify IndexNow Setup

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/bing-webmaster/docs/BING-WEBMASTER-SETUP.md

Run this command to verify that your IndexNow key is correctly set up and served at the specified URL.

```bash
/seo bing verify-indexnow
```

--------------------------------

### SaaS Site Architecture Example

Source: https://github.com/agricidaniel/claude-seo/blob/main/skills/seo-plan/assets/saas.md

Illustrates a recommended hierarchical site structure for a SaaS product, organizing content by product features, solutions, pricing, customer stories, resources, documentation, company information, and comparisons.

```text
/
├── Home
├── /product (or /platform)
│   ├── /features
│   │   ├── /feature-1
│   │   ├── /feature-2
│   │   └── ...
│   ├── /integrations
│   │   ├── /integration-1
│   │   └── ...
│   └── /security
├── /solutions
│   ├── /by-industry
│   │   ├── /industry-1
│   │   └── ...
│   └── /by-use-case
│       ├── /use-case-1
│       └── ...
├── /pricing
├── /customers
│   ├── /case-studies
│   │   ├── /case-study-1
│   │   └── ...
│   └── /testimonials
├── /resources
│   ├── /blog
│   ├── /guides
│   ├── /webinars
│   ├── /templates
│   └── /glossary
├── /docs (or /help)
│   └── /api
├── /company
│   ├── /about
│   ├── /careers
│   ├── /press
│   └── /contact
└── /compare
    ├── /vs-competitor-1
    └── /vs-competitor-2
```

--------------------------------

### Install Playwright via Pip and Playwright CLI

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/TROUBLESHOOTING.md

If the direct Playwright installation fails, first ensure Playwright is installed via pip, then use the Playwright CLI to install browser binaries.

```bash
pip install playwright
python3 -m playwright install chromium
```

--------------------------------

### Verify ImageMagick Installation

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/banana/docs/BANANA-SETUP.md

Check if ImageMagick is installed and its version by running the `magick --version` command. This confirms the installation for v7.

```bash
magick --version
```

--------------------------------

### Create Configuration Directory

Source: https://github.com/agricidaniel/claude-seo/blob/main/skills/seo-google/references/auth-setup.md

Creates the directory to store the Google API configuration file.

```bash
mkdir -p ~/.config/claude-seo
```

--------------------------------

### Install Banana Image Generation Extension

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/banana/README.md

Run this script to install the SEO image generation skill and agent. It verifies prerequisites, prompts for your Google AI API key, and configures the MCP server.

```bash
./extensions/banana/install.sh
```

--------------------------------

### Download requirements.txt

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/TROUBLESHOOTING.md

Download the requirements.txt file directly if it is missing from the skill directory.

```bash
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/requirements.txt \
  -o ~/.claude/skills/seo/requirements.txt
```

--------------------------------

### SoftwareApplication Schema

Source: https://github.com/agricidaniel/claude-seo/blob/main/skills/seo-competitor-pages/SKILL.md

Implement this schema for software products, detailing application category, operating system, and pricing. Replace placeholders with specific software details.

```json
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "[Software Name]",
  "applicationCategory": "[Category]",
  "operatingSystem": "[OS]",
  "offers": {
    "@type": "Offer",
    "price": "[Price]",
    "priceCurrency": "USD"
  }
}
```

--------------------------------

### Verify Profound Extension Installation

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/profound/docs/PROFOUND-SETUP.md

Use this command to verify that the Profound extension is correctly installed and functional for tracking citations.

```bash
/seo profound citations "Claude SEO"
```

--------------------------------

### Install Unlighthouse Extension

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/unlighthouse/docs/UNLIGHTHOUSE-SETUP.md

Run the appropriate installation script for your operating system (Linux/macOS or Windows). This script verifies dependencies, pre-warms the unlighthouse package, and copies the skill to the Claude skills directory.

```bash
./extensions/unlighthouse/install.sh
```

```powershell
.\extensions\unlighthouse\install.ps1
```

--------------------------------

### Install Profound Extension (Windows)

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/profound/docs/PROFOUND-SETUP.md

Execute this PowerShell script to install the Profound extension on Windows systems. It configures the PROFOUND_API_KEY.

```powershell
.\extensions\profound\install.ps1
```

--------------------------------

### Manage Presets via CLI

Source: https://github.com/agricidaniel/claude-seo/blob/main/skills/seo-image-gen/references/presets.md

Commands for listing, viewing, creating, and deleting presets using the presets.py script.

```bash
# List presets
presets.py list

# Show details
presets.py show tech-saas

# Create interactively (Claude fills in details from conversation)
presets.py create NAME --colors "#hex,#hex" --style "..." --mood "..."

# Delete
presets.py delete NAME --confirm
```

--------------------------------

### Install Playwright Browsers

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/INSTALLATION.md

Install Playwright and its browser binaries, specifically Chromium, for visual analysis capabilities. This is an optional step.

```bash
pip install playwright
playwright install chromium
```

--------------------------------

### Create custom preset script

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/banana/references/seo-image-presets.md

Executes the preset creation script to generate a new brand configuration file.

```bash
python3 ~/.claude/skills/seo-image-gen/scripts/presets.py create my-brand
```

--------------------------------

### Install Individual Python Packages

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/TROUBLESHOOTING.md

Install specific Python packages individually using pip with the --user flag.

```bash
pip install --user beautifulsoup4 requests lxml playwright Pillow urllib3 validators
```

--------------------------------

### Verify Manifest Consistency

Source: https://github.com/agricidaniel/claude-seo/blob/main/docs/MIGRATION-v1-to-v2.md

Run this command to confirm that the project's manifest files are consistent after the upgrade.

```python
python3 -m pytest tests/test_manifest_consistency.py -v
```

--------------------------------

### Install Firecrawl Extension

Source: https://github.com/agricidaniel/claude-seo/blob/main/extensions/firecrawl/skills/seo-firecrawl/SKILL.md

Install the Firecrawl extension using the provided bash script. Ensure you are in the project's root directory.

```bash
./extensions/firecrawl/install.sh
```