### Install Python Dependencies

Source: https://github.com/thecraighewitt/seomachine/blob/main/QUICK-START.md

Installs the necessary Python dependencies for the analysis modules using pip. Ensure you have Python and pip installed.

```bash
# Install Python dependencies for analysis modules
pip install -r data_sources/requirements.txt
```

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

### Create First Article with Claude Code

Source: https://github.com/thecraighewitt/seomachine/blob/main/QUICK-START.md

Commands to initiate the article creation process using Claude Code. This involves researching a topic, reviewing the brief, and then writing the article. The output will be found in the /drafts/ directory.

```bash
# Open in Claude Code
claude-code .

# Research a topic
/research [your topic]

# Review the research brief in /research/ directory

# Write the article
/write [topic]

# Check /drafts/ for your article + optimization reports
```

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

### SEO Machine Common Commands

Source: https://github.com/thecraighewitt/seomachine/blob/main/QUICK-START.md

A comprehensive list of commands for various SEO tasks within SEO Machine, including core workflow, analysis, research, and landing page management. These commands streamline content creation and optimization.

```bash
# Core workflow
/research [topic]           # Research before writing
/write [topic]              # Create new article
/article [topic]            # Simplified article creation
/rewrite [topic]            # Update old content
/optimize [file]            # Final SEO polish
/scrub [file]               # Remove AI watermarks
/publish-draft [file]       # Publish to WordPress

# Analysis
/analyze-existing [URL]     # Analyze existing post
/performance-review         # Analytics-driven priorities
/priorities                 # Content prioritization matrix

# Research
/research-serp [keyword]    # SERP analysis
/research-gaps              # Competitor content gaps
/research-trending          # Trending topics
/research-topics            # Topic clusters

# Landing pages
/landing-write [topic]      # Create landing page
/landing-audit [file]       # Audit for CRO issues
/landing-research [topic]   # Research positioning
```

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

### Install Project Dependencies

Source: https://github.com/thecraighewitt/seomachine/blob/main/CLAUDE.md

Installs the Python packages required to run the SEO Machine project. This command should be executed in the root directory of the project.

```bash
pip install -r data_sources/requirements.txt
```

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

### Get Keyword Rankings and Competitor Data (Python)

Source: https://github.com/thecraighewitt/seomachine/blob/main/data_sources/README.md

This snippet demonstrates how to use the 'dfs' library to fetch keyword rankings and analyze competitor data. It requires the 'dfs' library to be installed and configured with necessary API credentials.

```python
# Get keyword rankings
rankings = dfs.get_rankings(
    keywords=["podcast hosting", "podcast analytics"]
)

# Analyze competitor rankings
competitor_data = dfs.analyze_competitor(
    competitor_domain="competitor.com",
    keywords=["podcast hosting"]
)

# Get SERP data
serp = dfs.get_serp_data(keyword="podcast monetization")
```

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

### Install Dependencies (Bash)

Source: https://github.com/thecraighewitt/seomachine/blob/main/data_sources/README.md

Installs necessary Python packages for Google Analytics, Search Console, and general API requests. It can be done using pip with individual package names or by installing from a requirements file.

```bash
pip install google-analytics-data google-auth-oauthlib google-auth-httplib2
pip install google-api-python-client
pip install requests python-dotenv pandas
```

```bash
pip install -r data_sources/requirements.txt
```

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

### Run Integration Tests

Source: https://github.com/thecraighewitt/seomachine/blob/main/data-sources-setup.md

Commands to verify that the Google Analytics and Search Console integrations are correctly configured and fetching data.

```bash
npm run agent:ga4-traffic-data
npm run agent:gsc-search-data
```

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

### Create Credentials Directory (Bash)

Source: https://github.com/thecraighewitt/seomachine/blob/main/data-sources-setup.md

Creates the necessary 'credentials' directory if it does not already exist. This is often required for storing service account key files.

```bash
mkdir -p credentials/
```

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

### Run Keyword Research Agent (Bash)

Source: https://github.com/thecraighewitt/seomachine/blob/main/data-sources-setup.md

Executes the keyword research agent to gather keyword suggestions, search volume data, and keyword difficulty scores for a given target keyword. This command requires Node.js and npm to be installed.

```bash
npm run agent:keyword-research "your target keyword"
```

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

### Fetch DataForSEO Data (Python)

Source: https://github.com/thecraighewitt/seomachine/blob/main/data_sources/README.md

Provides an example of initializing the DataForSEO class to interact with the DataForSEO API. Further methods would be called on this instance to retrieve competitive SEO data and keyword research information.

```python
from data_sources.modules.dataforseo import DataForSEO

dfs = DataForSEO()


```

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

### Create SEO and PPC Landing Pages via CLI

Source: https://context7.com/thecraighewitt/seomachine/llms.txt

Generates conversion-optimized landing pages based on specific goals like trial signups or lead generation. The process automatically triggers a CRO scoring module upon completion.

```bash
# Create SEO landing page for trial signups
/landing-write "podcast hosting for beginners" --type seo --goal trial

# Create PPC landing page for demos
/landing-write "enterprise podcast solution" --type ppc --goal demo

# Create lead generation landing page
/landing-write "podcast monetization guide" --type seo --goal lead
```

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

### Environment Variables Configuration (Bash)

Source: https://github.com/thecraighewitt/seomachine/blob/main/data-sources-setup.md

Lists essential environment variables required for the SEOMachine project, including configurations for Google Analytics 4, Google Search Console, DataForSEO, and optional WordPress integration.

```bash
# Google Analytics 4
GA4_PROPERTY_ID=123456789

# Google Search Console
GSC_SITE_URL=https://yoursite.com/
COMPANY_NAME=Your Company

# DataForSEO
DATAFORSEO_LOGIN=your_username
DATAFORSEO_PASSWORD=your_api_password

# WordPress (optional, for /publish-draft)
WP_URL=https://yoursite.com
WP_USERNAME=your_username
WP_APP_PASSWORD=your_application_password
```

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

### GET /dataforseo/rankings

Source: https://context7.com/thecraighewitt/seomachine/llms.txt

Fetches search engine ranking data for a specific domain across a list of keywords.

```APIDOC
## GET /dataforseo/rankings

### Description
Retrieves current search engine positions for a domain based on provided keywords.

### Method
GET

### Endpoint
/dataforseo/rankings

### Parameters
#### Query Parameters
- **domain** (string) - Required - The domain to check rankings for.
- **keywords** (array) - Required - List of keywords to analyze.

### Request Example
{
  "domain": "yoursite.com",
  "keywords": ["podcast hosting", "podcast analytics"]
}

### Response
#### Success Response (200)
- **keyword** (string) - The keyword searched.
- **position** (integer) - The current ranking position.
- **search_volume** (integer) - Monthly search volume for the keyword.

#### Response Example
[
  {
    "keyword": "podcast hosting",
    "position": 1,
    "search_volume": 5000
  }
]
```