AI agent skill for querying the PageRangers Monitoring API. Works with Claude Code, Codex CLI, and other AI assistants supporting the Agent Skills specification.
- Keyword Analysis: SERP data, search volume, competition levels
- Rankings: Current keyword positions and ranking URLs
- KPIs: Ranking index, top 10/100 counts, average position
- Prospects: High-opportunity keyword identification
# 1. Create credentials file
cat > ~/.env.pagerangers << 'EOF'
PAGERANGERS_API_TOKEN=your_api_key_here
PAGERANGERS_PROJECT_HASH=your_project_hash_here
EOF
# 2. Run commands (--json flag must come before subcommand)
python3 scripts/pagerangers.py --json kpis
python3 scripts/pagerangers.py --json rankings --limit 10
python3 scripts/pagerangers.py --json keyword "SEO tools" --top 5
python3 scripts/pagerangers.py --json prospects --limit 10Add the Netresearch marketplace once, then browse and install skills:
# Claude Code
/plugin marketplace add netresearch/claude-code-marketplacenpx (skills.sh)
Install with any Agent Skills-compatible agent:
npx skills add https://github.com/netresearch/pagerangers-skill --skill pagerangers-seoDownload the latest release and extract to your agent's skills directory.
git clone https://github.com/netresearch/pagerangers-skill.gitcomposer require netresearch/pagerangers-skillRequires netresearch/composer-agent-skill-plugin.
# Install dev dependencies
uv pip install -e ".[dev]"
# Run tests
pytest
# Run tests with coverage
pytest --cov=scripts --cov-report=html
# Lint code
ruff check scripts tests
# Format code
ruff format scripts testspagerangers-seo/
├── .claude-plugin/ # Claude Code plugin manifest
│ └── plugin.json
├── scripts/ # CLI scripts
│ └── pagerangers.py
├── references/ # API documentation
│ ├── pagerangers-api.json
│ └── pagerangers-api.md
├── tests/ # Pytest test suite
│ ├── conftest.py
│ └── test_pagerangers.py
├── SKILL.md # Skill definition
├── AGENTS.md # Agent documentation
├── pyproject.toml # Python project config
└── README.md # This file
| Variable | Required | Description |
|---|---|---|
PAGERANGERS_API_TOKEN |
Yes | API key from PageRangers profile |
PAGERANGERS_PROJECT_HASH |
Yes | Project identifier |
PAGERANGERS_BASE_URL |
No | Override API URL |
PAGERANGERS_TIMEOUT |
No | Request timeout (default: 30s) |
- Log in to PageRangers
- Go to Profile → API Settings
- Copy API Token and Project Hash
- Store in
~/.env.pagerangers
See references/pagerangers-api.md for complete API documentation.
- Fork the repository
- Create a feature branch
- Write tests for new functionality
- Ensure all tests pass:
pytest - Ensure code is formatted:
ruff format - Submit a pull request
This project uses split licensing:
- Code (scripts, workflows, configs): MIT
- Content (skill definitions, documentation, references): CC-BY-SA-4.0
See the individual license files for full terms.