nodeshub-seo-skills

By cloning or downloading this repository you accept the terms described in TERMS-OF-USE.md.

NodesHub SEO Skills – documentation

A set of skills for SEO automation, built on the NodesHub API (live Google SERP data) and optionally OpenRouter (LLM for cluster naming and brief generation).

The toolkit consists of two layers:

• Skills layer (SKILL.md) – Native integration with Claude Code. Type something like /nod-serp-analysis and Claude automatically knows what to do: it runs the script, analyzes the results, and returns a formatted report. Slash commands, automatic context, intent recognition – this only works in Claude Code.
• Python scripts layer – Fully standalone. Each skill has scripts that can be run from any terminal, CI pipeline, or other AI tool (Gemini CLI, Cursor, Aider). Just set your API key.

SERP data is fetched live from Google (not from a historical database), so results reflect the current state of search.

What this repository is

This repository is a promotional package created by Senuto to demonstrate the capabilities of the NodesHub platform. It is a collection of instructions (SKILL.md files), Python scripts, and configuration templates that extend Claude Code – Anthropic's AI terminal tool – with SEO-related functionality.

It is not a standalone application. It is an add-on layer for Claude Code that connects to the NodesHub API for data. Here is how it works step by step:

1. The user installs Claude Code (a paid Anthropic product).
2. The user downloads this repository to their computer or server from the public GitHub repository.
3. The user navigates to the repository folder in their terminal.
4. The user types commands such as /nod-serp-analysis "keyword" – Claude Code reads the included instructions and performs the analysis in a defined way.
5. In the background, Python scripts connect to the NodesHub API to fetch SERP data, and Claude Code interprets and presents the results.
6. To use the full capabilities of the repository, the user must separately purchase a NodesHub plan and provide their NodesHub API key to Claude Code.
7. Everything runs locally on the user's computer – no server is involved, and no user data is stored by Senuto or NodesHub.

What is NodesHub?

NodesHub is a SERP data API built by Senuto. It fetches Google search results in real time and returns them as structured JSON. Instead of building your own scraper (and dealing with proxies, CAPTCHAs, rate limits, and constant maintenance), you make one API call and get back everything Google shows for a given query: organic results, featured snippets, People Also Ask, AI Overviews, Knowledge Graph panels, Local Pack, Videos, Top Stories, ads, and more.

NodesHub exposes three main endpoints:

• SERPdata API — the core endpoint. Returns the full Google SERP for any keyword, in any country and language. One call = one token. You get the top 10 organic results, all SERP features present on the page, and metadata like search volume signals and result types.
• Query Fan-out — takes a seed keyword and expands it into 15–20 related queries, questions, and long-tail variations using AI. Useful for keyword research and topical mapping. One call = 7.5 tokens (standard) or 30 tokens (reasoning mode for higher quality).
• Intent Classifier — analyzes the actual SERP (not the keyword text) to determine whether a query is informational, commercial, transactional, or navigational. Returns a percentage confidence score for each category. One call = 2 tokens.

All data is live — fetched from Google at the moment you make the request, not pulled from a historical database. This means results always reflect the current state of search.

NodesHub is pay-as-you-go with no subscription required. New users receive 100 free tokens on sign-up — enough to run a full keyword research session, several SERP analyses, or a content brief. API keys are available in the NodesHub Playground.

Installation

Clone the repo:

git clone https://github.com/Senuto/nodeshub-seo-skills.git

Requirements

• Claude Code – for full integration (slash commands, automatic context). Alternatively, scripts can be run manually from any terminal.
• Python 3.9+ – to run the scripts.
• NodesHub API key – to fetch SERP data (free 100 tokens included upon registration). Required for most skills.
• OpenRouter API key – required for SERP Clusters (naming), PAA Miner (clustering), and Topic Planner (briefs). Not required for other skills.
• Genuino API key (optional) – required for AI Score, Keyword to Publish, and Content Humanizer.
• Jina API key (optional) – for crawling competitor pages in Topic Planner and for URL-based AI Score analysis.

Configuration (one-time setup)

Connecting NodesHub