213 lines
4.8 KiB
Markdown
213 lines
4.8 KiB
Markdown
# @spy Research Brief: Documentation SEO Analysis
|
|
|
|
**Date:** January 2, 2026
|
|
**Priority:** Medium
|
|
**Requested by:** @men (strategy session)
|
|
**Budget limit:** $0.50 DataForSEO
|
|
|
|
---
|
|
|
|
## Context
|
|
|
|
We've launched documentation section at `banatie.app/docs/` with 10 pages. SEO metadata and JSON-LD schemas are implemented. Now we need competitive intelligence to identify potential improvements.
|
|
|
|
**Constraint:** No major content changes — this is technical documentation. Looking for small optimizations and gaps we might be missing.
|
|
|
|
---
|
|
|
|
### Task 0: Free search and analysis of existing documentation section
|
|
|
|
**Goal:** Inspect real NextJS pages for potential content improvements and to be aware of what exact content we have in docs section
|
|
|
|
Browse docs section in landing app project (NextJS) using Filesystem MCP:
|
|
|
|
`/projects/my-projects/banatie-service/apps/landing/src/app/(apps)/docs`
|
|
|
|
Understand the content. Collect the list of potential topics and keywords we can consider to promote via SEO
|
|
|
|
---
|
|
|
|
## Research Tasks
|
|
|
|
### Task 1: Keyword Opportunities
|
|
|
|
**Goal:** Find keywords developers use when searching for image generation API documentation.
|
|
|
|
**DataForSEO queries:**
|
|
|
|
```
|
|
Seeds to research:
|
|
- "image generation api"
|
|
- "ai image api documentation"
|
|
- "text to image api tutorial"
|
|
- "generate image from prompt api"
|
|
```
|
|
|
|
**What to find:**
|
|
1. Related keywords with Volume > 50, KD < 40
|
|
2. Long-tail variations we might target
|
|
3. Question-based keywords ("how to generate image with api")
|
|
|
|
**Output format:**
|
|
```
|
|
| Keyword | Volume | KD | Intent | Opportunity |
|
|
|---------|--------|-----|--------|-------------|
|
|
```
|
|
|
|
---
|
|
|
|
### Task 2: Competitor Documentation Structure
|
|
|
|
**Goal:** Understand what sections competitors have that we might be missing.
|
|
|
|
**Targets to analyze:**
|
|
1. `docs.replicate.com` — market leader in AI model APIs
|
|
2. `fal.ai/docs` — direct competitor, similar positioning
|
|
3. `docs.runware.ai` — budget competitor
|
|
4. `cloudinary.com/documentation` — gold standard for image APIs
|
|
|
|
**What to check:**
|
|
- Main navigation structure (what sections exist)
|
|
- Do they have interactive elements? (playgrounds, live code)
|
|
- Do they have SDK/CLI docs? (we don't yet but plan to)
|
|
- Any unique sections we don't have?
|
|
|
|
**Output format:**
|
|
```
|
|
## [Competitor Name]
|
|
|
|
**URL:** ...
|
|
**Main sections:**
|
|
- Section 1
|
|
- Section 2
|
|
...
|
|
|
|
**Unique elements:**
|
|
- ...
|
|
|
|
**What we could adopt:**
|
|
- ...
|
|
```
|
|
|
|
---
|
|
|
|
### Task 3: SERP Analysis
|
|
|
|
**Goal:** Understand what type of content ranks for our target queries.
|
|
|
|
**Queries to check:**
|
|
1. "image generation api"
|
|
|
|
|
|
|
|
|
|
## Deliverables
|
|
|
|
Create file: `/banatie-content/research/keywords/docs-seo-analysis-2026-01-02.md`
|
|
|
|
Structure:
|
|
```
|
|
## Deliverables
|
|
|
|
Create file: `/banatie-content/research/keywords/docs-seo-analysis-2026-01-02.md`
|
|
|
|
Structure:
|
|
```
|
|
2. "ai image api documentation"
|
|
3. "text to image rest api"
|
|
4. "generate image from text api"
|
|
|
|
**What to note:**
|
|
- Who ranks in top 10?
|
|
- What content type? (landing page, docs, tutorial, blog post)
|
|
- Any featured snippets? What format?
|
|
- Do any competitors appear?
|
|
|
|
**Output format:**
|
|
```
|
|
## Query: "[keyword]"
|
|
|
|
**Top 3 results:**
|
|
1. [URL] — [Type: landing/docs/blog] — [Brief description]
|
|
2. ...
|
|
3. ...
|
|
|
|
**Featured snippet:** Yes/No — [Format if yes]
|
|
**Our competitors present:** [List]
|
|
```
|
|
|
|
---
|
|
|
|
### Task 4: Content Gap Analysis (Optional if budget allows)
|
|
|
|
**Goal:** Find keywords competitors rank for that we don't cover.
|
|
|
|
**Method:** Use DataForSEO `domain_intersection` or `ranked_keywords` for:
|
|
- replicate.com/docs
|
|
- fal.ai/docs
|
|
|
|
Filter for keywords with:
|
|
- Volume > 100
|
|
- Related to image generation
|
|
- We have no content for
|
|
|
|
---
|
|
|
|
|
|
|
|
## Deliverables
|
|
|
|
Create file: `/banatie-content/research/keywords/docs-seo-analysis-2026-01-02.md`
|
|
|
|
Structure:
|
|
```markdown
|
|
# Documentation SEO Analysis
|
|
|
|
**Date:** January 2, 2026
|
|
**Research by:** @spy
|
|
|
|
## Executive Summary
|
|
[2-3 key findings]
|
|
|
|
## 1. Keyword Opportunities
|
|
[Task 1 results]
|
|
|
|
## 2. Competitor Structure Analysis
|
|
[Task 2 results]
|
|
|
|
## 3. SERP Analysis
|
|
[Task 3 results]
|
|
|
|
## 4. Content Gaps (if completed)
|
|
[Task 4 results]
|
|
|
|
## Recommendations
|
|
[Prioritized list of actionable improvements]
|
|
|
|
## Strategic Signals
|
|
[Anything that should go to banatie-strategy/inbox/]
|
|
```
|
|
|
|
---
|
|
|
|
## Notes for @spy
|
|
|
|
- Focus on actionable insights, not comprehensive data dumps
|
|
- If something is strategically important (funding, major competitor move), create separate file in `banatie-strategy/inbox/`
|
|
- Budget is limited — prioritize Tasks 1-3, Task 4 only if budget remains
|
|
- We're NOT changing our documentation structure significantly — looking for small wins
|
|
|
|
---
|
|
|
|
## Success Criteria
|
|
|
|
Good research will answer:
|
|
1. Are there keywords with decent volume that we should add to our pages?
|
|
2. Are competitors doing something in their docs that we should consider?
|
|
3. What content type does Google prefer for these queries?
|
|
4. Any quick wins we can implement this week?
|
|
|
|
---
|
|
|
|
**End of Brief**
|