hive-rank 3.0.0

package/commands/baseline.md

@@ -0,0 +1,39 @@
+---
+name: baseline
+description: Establish baseline rankings for your target keywords
+allowed-tools:
+  - mcp: hive-rank
+    tools:
+      - hive_rankings
+      - hive_domain
+      - hive_search
+---
+
+Establish baseline rankings for $ARGUMENTS.
+
+**Input formats:**
+- Domain only: `/hive:baseline kinsta.com` — will ask for target keywords
+- Keywords only: `/hive:baseline best wordpress hosting, kinsta vs wp engine` — will ask for domain
+- Both: `/hive:baseline kinsta.com best wordpress hosting, managed wp hosting`
+
+If no arguments are provided, ask the user for their top 5-10 target keywords and their domain.
+
+For each keyword provided:
+1. WebSearch the exact keyword to capture the current SERP
+2. Note where the user's domain ranks (if provided)
+
+After all searches complete:
+- Use `hive_rankings` on each keyword to see network-wide data
+- Use `hive_domain` (if domain provided) to check network data for that domain
+- Present a ranking baseline table:
+
+| Keyword | Your Position | Top Competitor | Network Data Available |
+|---------|--------------|----------------|------------------------|
+| ... | ... | ... | Yes/No |
+
+For each keyword, note:
+- Current position (from fresh WebSearch)
+- Top competitors visible
+- Whether the network has historical data
+
+Suggest running this monthly to track changes over time. Each search contributes to the network, building richer historical data.

package/commands/competitors.md

@@ -0,0 +1,37 @@
+---
+name: competitors
+description: Discover and analyze your SEO competitors
+allowed-tools:
+  - mcp: hive-rank
+    tools:
+      - hive_domain
+      - hive_search
+      - hive_rankings
+---
+
+Find and analyze SEO competitors for the specified domain (or ask me which domain).
+
+**Step 1 — Identify the Domain:**
+If no domain is specified, ask the user which domain to analyze.
+
+**Step 2 — Research Competitors:**
+- WebSearch the domain's brand name
+- WebFetch the homepage to understand what they do
+- WebSearch "[domain] vs" and "[domain] alternatives"
+- WebSearch 3-5 key product/service keywords related to their niche
+
+**Step 3 — Network Intelligence:**
+- Use `hive_domain` to get network data on this domain
+- Use `hive_search` to find related queries in the network
+- For each competitor identified, use `hive_domain` to compare presence
+
+**Step 4 — Analysis:**
+Present a clear summary:
+- Who the top competitors are (appear for same keywords)
+- Apparent strengths of each competitor
+- Gaps and weaknesses you could exploit
+- Recommended next steps
+
+Each search contributes to the network, building competitive intelligence for everyone.
+
+$ARGUMENTS

package/commands/content.md

@@ -0,0 +1,39 @@
+---
+name: content
+description: Research a topic and generate an SEO-optimized content brief
+allowed-tools:
+  - mcp: hive-rank
+    tools:
+      - hive_rankings
+      - hive_search
+---
+
+Research and create an SEO content brief for: $ARGUMENTS
+
+If no topic or keyword is specified, ask the user what topic to research.
+
+**Step 1 — SERP Research:**
+- WebSearch the primary keyword to capture the current SERP
+- WebSearch 2-3 variations (question format, long-tail, commercial intent)
+- WebFetch the top 3 ranking pages to analyze their content
+
+**Step 2 — Pattern Analysis:**
+From the WebFetch results, identify:
+- Common title patterns (listicle, guide, comparison, etc.)
+- H1 structures that rank well
+- Content depth and format
+- Key terms and topics covered
+
+**Step 3 — Network Intelligence:**
+- Use `hive_rankings` to see network data for this keyword
+- Use `hive_search` to find related queries
+
+**Step 4 — Deliver Content Brief:**
+
+- **Target keyword** + secondary keywords (from your research)
+- **Search intent** — informational, commercial, transactional, navigational
+- **Recommended title** — based on patterns that rank
+- **Content format** — listicle, guide, comparison, review, etc.
+- **Key sections to include** — based on what top results cover
+- **Differentiation angle** — gaps in existing content you could fill
+- **Word count guidance** — based on top-ranking content depth

package/commands/grow.md

@@ -0,0 +1,40 @@
+---
+name: grow
+description: Weekly SEO growth check — new opportunities, ranking changes, fresh data
+allowed-tools:
+  - mcp: hive-rank
+    tools:
+      - hive_domain
+      - hive_trending
+      - hive_rankings
+      - hive_search
+---
+
+Run a weekly SEO growth check for $ARGUMENTS.
+
+If no domain is specified, ask which domain to analyze.
+
+**Step 1 — Refresh Core Data:**
+- WebSearch the domain's brand name
+- WebSearch 3-5 key product/service keywords
+- WebSearch 2-3 new keyword variations or long-tail extensions
+- WebSearch the domain name plus any known competitors
+
+**Step 2 — Check Network Intelligence:**
+- Use `hive_domain` to get current network data for this domain
+- Use `hive_trending` to spot what's moving network-wide
+- Use `hive_rankings` on top keywords to see aggregated positions
+
+**Step 3 — Discover Opportunities:**
+- WebSearch 2-3 question-format queries related to the niche
+- WebSearch 1-2 trending or seasonal keywords
+- WebFetch any new competitor pages discovered
+
+**Step 4 — Present Summary:**
+- What's the domain's current visibility?
+- Any notable trends from the network?
+- New competitors or threats identified?
+- One quick-win opportunity to act on this week
+- What to research next time
+
+Run this weekly to keep contributing fresh data to the network. The more you search, the richer the collective intelligence becomes.

package/commands/help.md

@@ -0,0 +1,67 @@
+---
+name: help
+description: Show all Hive Rank commands and tools
+allowed-tools: []
+---
+
+Show me a usage guide for Hive Rank. List all available slash commands and MCP tools.
+
+**IMPORTANT:** Reproduce ALL sections below exactly — do not summarize, omit, or abbreviate any commands, tables, or content.
+
+**Hive Rank is a crowdsourced SEO intelligence network.** Every WebSearch and WebFetch you run automatically contributes anonymized data to the hive. The more agents contribute, the richer the collective intelligence becomes.
+
+**Slash Commands — Research (generates data for the hive):**
+
+These commands guide SEO research. Every WebSearch and WebFetch they trigger contributes to the network.
+
+| Command | What it does |
+|---------|-------------|
+| `/hive:kickstart [domain]` | **Start here.** Bootstrap SEO research — site analysis, competitors, keyword landscape |
+| `/hive:baseline [domain] [keywords...]` | Establish baseline rankings for target keywords |
+| `/hive:grow [domain]` | Weekly growth check — fresh data, ranking changes, new opportunities |
+| `/hive:spy [competitor]` | Deep-dive into a competitor's SEO strategy |
+| `/hive:content [topic]` | Research a topic and generate an SEO content brief |
+| `/hive:learn [topic]` | Learn SEO concepts with real examples |
+| `/hive:audit-site [domain]` | Run a technical SEO audit on a website |
+
+**Slash Commands — Network Intelligence:**
+
+These commands query the hive network for aggregated insights.
+
+| Command | What it does |
+|---------|-------------|
+| `/hive:rankings [query]` | Check network ranking data for a query |
+| `/hive:trends` | See what's trending across the network |
+| `/hive:competitors [domain]` | Find competitors via network intelligence |
+| `/hive:keywords [domain]` | Find keyword opportunities |
+| `/hive:report [domain]` | Generate an SEO report from network data |
+| `/hive:audit` | Check network contribution status |
+| `/hive:status` | Hive network status and your contribution stats |
+| `/hive:help` | This help guide |
+
+**MCP Tools (6 network tools via hive-rank server):**
+
+| Tool | What it does |
+|------|-------------|
+| `hive_stats` | Network statistics — contributors, observations, coverage |
+| `hive_rankings(query)` | Aggregated ranking data from the network |
+| `hive_trending` | What's gaining/losing across all contributors |
+| `hive_domain(domain)` | Domain intelligence from network observations |
+| `hive_contributors` | Contributor activity and leaderboard |
+| `hive_search(term)` | Full-text search across network data |
+
+**How it works:**
+
+1. **You search** — Every WebSearch and WebFetch captures SEO data
+2. **Hook contributes** — The PostToolUse hook sends anonymized data to the network
+3. **Network grows** — Aggregated insights become available via `hive_*` tools
+4. **Everyone benefits** — Richer data for all agents in the network
+
+**Privacy:**
+- Only public search data is shared (queries, URLs, positions — visible to anyone searching)
+- Your identity is hashed (SHA-256, one-way) — no account, not trackable
+- Timestamps are bucketed to date-only to prevent session correlation
+
+**Dashboard:** https://www.hive-rank.com
+
+$ARGUMENTS

package/commands/keywords.md

@@ -0,0 +1,48 @@
+---
+name: keywords
+description: Find keyword opportunities for a domain
+allowed-tools:
+  - mcp: hive-rank
+    tools:
+      - hive_domain
+      - hive_search
+      - hive_rankings
+      - hive_trending
+---
+
+Find keyword opportunities for the specified domain.
+
+If no domain is specified, ask which domain to analyze.
+
+**Step 1 — Understand the Domain:**
+- WebFetch the homepage to understand what they do
+- WebSearch the brand name to see current visibility
+- Use `hive_domain` to check network data
+
+**Step 2 — Research Keyword Landscape:**
+- WebSearch 5-8 key product/service keywords
+- WebSearch 3-5 informational "how to" queries
+- WebSearch 2-3 commercial "best [category]" queries
+- WebSearch "[domain] vs [competitor]" patterns
+
+**Step 3 — Network Intelligence:**
+- Use `hive_search` to find related queries in the network
+- Use `hive_rankings` on promising keywords
+- Use `hive_trending` to identify rising opportunities
+
+**Step 4 — Synthesize Opportunities:**
+
+Present findings in three categories:
+
+1. **Quick Wins** — Keywords where the domain already appears but could rank higher
+2. **Gaps** — Keywords competitors rank for that this domain doesn't
+3. **Emerging** — Trending queries in the network that align with the domain's niche
+
+For each category, present 5-10 keywords with:
+- Current position (if any)
+- Competitor presence
+- Opportunity assessment
+
+End with 2-3 specific action items.
+
+$ARGUMENTS

package/commands/kickstart.md

@@ -0,0 +1,43 @@
+---
+name: kickstart
+description: Bootstrap your SEO research — analyzes a site, finds competitors, maps keyword landscape
+allowed-tools:
+  - mcp: hive-rank
+    tools:
+      - hive_stats
+      - hive_domain
+      - hive_search
+---
+
+Perform a comprehensive SEO kickstart analysis for $ARGUMENTS.
+
+If no domain is specified, ask the user which domain/site to analyze.
+
+**Phase 1 — Site Discovery:**
+- WebSearch the domain name to see how it appears in results
+- WebFetch the homepage and 2-3 key pages to capture metadata
+- WebSearch "site:[domain]" to discover indexed pages
+
+**Phase 2 — Competitive Landscape:**
+- WebSearch the domain's primary product/service keywords (infer from homepage content)
+- WebSearch "[domain] vs" and "[domain] alternatives" to find competitors
+- WebFetch the top 3 competitor homepages
+
+**Phase 3 — Keyword Landscape:**
+- WebSearch 5-8 high-intent keywords related to the site's niche
+- WebSearch 3-5 informational queries the site's audience would ask
+- WebSearch 2-3 "best [category]" and "how to [topic]" queries
+
+**Phase 4 — Network Check:**
+- Use `hive_stats` to confirm the network is available
+- Use `hive_domain` to check if the network has existing data for this domain
+- Use `hive_search` to find related queries already in the network
+
+Present a clear summary:
+- What the site does and who it competes with
+- Key pages and their content focus
+- Competitors identified
+- Top 3 immediate opportunities spotted
+- What to research next to deepen understanding
+
+This kickstart contributes all your searches to the hive network, building intelligence for everyone.

package/commands/learn.md

@@ -0,0 +1,80 @@
+---
+name: learn
+description: Learn SEO concepts with real examples
+allowed-tools:
+  - mcp: hive-rank
+    tools:
+      - hive_stats
+      - hive_rankings
+      - hive_domain
+      - hive_search
+      - hive_trending
+---
+
+The user wants to learn about SEO. Topic requested: $ARGUMENTS
+
+If the topic is empty or unspecified, present the topics below as a numbered list and ask the user to pick one.
+
+**Learning Path** (start at the top if you're new to SEO):
+
+Beginner:
+1. "keyword research" — how to find what people search for and which terms to target
+2. "search intent" — why matching what searchers want matters more than keyword volume
+3. "on-page optimization" — what top-ranking pages have in common and how to match them
+
+Intermediate:
+4. "content strategy" — planning content around topics and gaps in the market
+5. "competitor analysis" — understanding who you're competing against and where they're weak
+
+Advanced:
+6. "technical seo" — site structure, internal linking, and crawlability fundamentals
+
+---
+
+**How to teach each topic:**
+
+**Step 1 — Explain the Principle:**
+- 2-3 sentences explaining the concept
+- Why it matters for rankings
+
+**Step 2 — Demonstrate with Live Research:**
+
+Use WebSearch and WebFetch to show real examples, then use network tools to add context.
+
+For **keyword research**:
+- WebSearch 3 related queries in a sample niche
+- Use `hive_search` to find related queries in the network
+- Teach: keyword research is about finding clusters of related queries, not just individual keywords
+
+For **search intent**:
+- WebSearch queries with different intents: informational, commercial, transactional
+- Analyze the results — what content type ranks for each?
+- Teach: matching intent is why a buying guide outranks a product page for "best X" queries
+
+For **on-page optimization**:
+- WebSearch a competitive keyword
+- WebFetch the top 3 results
+- Analyze title patterns, H1 structures, content depth
+- Teach: on-page optimization is reverse-engineering what already works
+
+For **content strategy**:
+- WebSearch a niche from multiple angles
+- Use `hive_domain` to show how different sites cover different topics
+- Teach: content strategy is about covering topic clusters completely
+
+For **competitor analysis**:
+- WebSearch a main keyword to see who ranks
+- WebFetch competitor pages
+- Use `hive_trending` to see who's gaining/losing
+- Teach: competitor analysis reveals opportunities by showing gaps
+
+For **technical seo**:
+- WebSearch "site:[domain]" to check indexation
+- WebFetch key pages and check metadata
+- Teach: technical SEO ensures search engines can find and understand your content
+
+**Step 3 — Actionable Takeaway:**
+- One specific thing the user can do right now
+
+**Step 4 — Practice Exercise:**
+A hands-on task that reinforces the concept AND contributes data to the network.

package/commands/rankings.md

@@ -0,0 +1,22 @@
+---
+name: rankings
+description: Check network ranking data for a search query
+allowed-tools:
+  - mcp: hive-rank
+    tools:
+      - hive_rankings
+      - hive_trending
+      - hive_stats
+---
+
+Show me the ranking data for the specified query.
+
+1. Use `hive_rankings` to pull network ranking data for this query
+2. Use `hive_trending` to see if this query is trending up or down
+3. Present a clear summary: who's ranking, what positions, and any notable patterns
+
+If no query is specified, ask me what query to look up.
+
+If the network has limited data for this query, suggest running a WebSearch to contribute fresh data.
+
+$ARGUMENTS

package/commands/report.md

@@ -0,0 +1,40 @@
+---
+name: report
+description: Generate an SEO report from network data
+allowed-tools:
+  - mcp: hive-rank
+    tools:
+      - hive_domain
+      - hive_rankings
+      - hive_trending
+      - hive_search
+      - hive_stats
+---
+
+Generate a comprehensive SEO report for the specified domain (or ask me which domain to analyze).
+
+**Step 1 — Gather Network Intelligence:**
+- Use `hive_domain` to get all network data for this domain
+- Use `hive_search` to find related queries in the network
+- Use `hive_trending` to identify movement patterns
+
+**Step 2 — Enrich with Fresh Research:**
+- WebSearch the domain's brand name
+- WebSearch 3-5 key queries related to their niche
+- WebFetch the homepage and key pages
+
+**Step 3 — Compile Report:**
+
+Present a markdown report with these sections:
+
+1. **Domain Overview** — What the site does, key pages, apparent focus
+2. **Network Presence** — How the domain appears across hive network data
+3. **Ranking Snapshot** — Current positions for key queries (from hive_rankings + fresh searches)
+4. **Trends** — What's moving up or down (from hive_trending)
+5. **Competitive Context** — Who else appears for similar queries
+6. **Opportunities** — Gaps and quick wins identified
+7. **Next Steps** — Specific recommendations
+
+If network data is sparse for this domain, note this and rely more on fresh WebSearch/WebFetch research.
+
+$ARGUMENTS

package/commands/spy.md

@@ -0,0 +1,48 @@
+---
+name: spy
+description: Deep-dive analysis of a specific competitor's SEO strategy
+allowed-tools:
+  - mcp: hive-rank
+    tools:
+      - hive_domain
+      - hive_rankings
+      - hive_search
+      - hive_trending
+---
+
+Perform a deep competitive analysis of $ARGUMENTS.
+
+If no competitor domain is specified, ask the user which competitor to analyze.
+
+**Step 0 — Establish Context:**
+- Confirm the competitor domain to analyze
+- Ask the user for their own domain (to enable competitive framing)
+
+**Step 1 — Map Their Presence:**
+- WebSearch the competitor's brand name
+- WebFetch their homepage, about page, and blog index
+- WebSearch "site:[competitor]" to estimate indexed pages
+- WebSearch "[competitor] reviews" to understand market perception
+
+**Step 2 — Reverse-Engineer Their Keywords:**
+- WebFetch their top 5 pages (discovered from search results)
+- For each page: infer target keywords from title, H1, content
+- WebSearch those inferred keywords to see where they rank
+
+**Step 3 — Network Intelligence:**
+- Use `hive_domain` on the competitor to see network data
+- Use `hive_search` to find queries related to the competitor
+- Use `hive_trending` to see if the competitor is gaining or losing
+
+**Step 4 — Find Their Weaknesses:**
+- WebSearch long-tail variations of their top keywords
+- Look for keywords where they rank #4-10 (vulnerable positions)
+- Compare with your domain using `hive_domain`
+
+**Step 5 — Present Analysis:**
+- Their keyword strategy (what they're targeting)
+- Where they're strong vs where they're weak
+- 3-5 specific keywords you could take from them
+- Content approach needed to win those keywords
+
+Each search contributes to the network, building competitive intelligence for everyone.

package/commands/status.md

@@ -0,0 +1,45 @@
+---
+name: status
+description: Check hive network status, contribution stats, and network intelligence
+allowed-tools:
+  - mcp: hive-rank
+    tools:
+      - hive_stats
+      - hive_rankings
+      - hive_trending
+      - hive_domain
+      - hive_contributors
+      - hive_search
+---
+
+Check the status of the Hive Rank network.
+
+**Step 1: Get network statistics**
+
+Call `hive_stats()` to get current network data:
+- Total contributors
+- Total observations
+- Query coverage
+- Recent activity
+
+**Step 2: Show network activity**
+
+Call `hive_contributors()` to see who's active and `hive_trending()` to show what's moving.
+
+Present the results clearly:
+- Network health summary
+- Top trending queries/domains
+- Recent contributor activity
+
+**Important — Early Network Context:**
+
+The hive network may still be growing. If results are sparse, explain: "The hive network grows richer as more agents contribute. Every search you make helps build collective intelligence."
+
+**Hive Network Info:**
+- The hive is a shared network where agents contribute anonymized search data
+- The hive server runs at mcp.hive-rank.com — dashboard at www.hive-rank.com
+- Only public search data is shared (queries, URLs, positions — already visible to anyone searching)
+- Your identity is hashed (SHA-256, one-way) — no account, not trackable
+- Timestamps are bucketed to date-only to prevent session correlation
+
+$ARGUMENTS

package/commands/trends.md

@@ -0,0 +1,44 @@
+---
+name: trends
+description: See what's trending across the hive network
+allowed-tools:
+  - mcp: hive-rank
+    tools:
+      - hive_trending
+      - hive_domain
+      - hive_stats
+---
+
+Show me what's trending in the hive network.
+
+**Interpret the user's argument to determine the mode:**
+
+- **No argument:** Show network-wide trends — what's gaining/losing across all contributors.
+- **Domain argument** (e.g., `kinsta.com`): Show trends scoped to that domain using `hive_domain`.
+- **Query argument** (e.g., `"react frameworks 2026"`): Show trends for that specific query.
+
+If it's ambiguous whether the argument is a domain or a query, treat anything with a TLD (`.com`, `.io`, `.org`, etc.) as a domain, and everything else as a query.
+
+**Mode A — Network-wide (no argument):**
+1. Use `hive_trending` to get aggregate movers across the network
+2. Use `hive_stats` to provide context on network size and coverage
+3. Present the biggest gainers and losers network-wide
+
+**Mode B — Domain-scoped (domain argument):**
+1. Use `hive_domain` to get network intelligence on this domain
+2. Use `hive_trending` filtered to this domain if possible
+3. Present trends from the domain's perspective
+
+**Mode C — Query-scoped (query argument):**
+1. Use `hive_trending` filtered to the specified query
+2. Present which URLs are gaining or losing for that query
+
+**Present a summary of:**
+- Biggest gainers (URLs climbing in rankings)
+- Biggest losers (URLs dropping)
+- New entries and exits
+- Any patterns worth noting
+
+If network data is sparse, suggest WebSearching relevant queries to contribute fresh data.
+
+$ARGUMENTS