Informational, commercial, transactional, navigational; drives structure, CTA, SEO depth
product-marketing-context Section 6 (target intent); article orientation; content type
Competitor articles
Structure to adopt, content gaps, length target, keyword opportunities
User-provided URLs; product-marketing-context Section 11; web search
When any input is missing
Proactively ask or search. For article analysis: perform
Research Phase
(keyword search, search intent, competitor articles) by default — see Research Phase section. For product/keywords/intent, infer from article or prompt user to add product-marketing-context.
Extract product name, features, URLs; infer target keyword and audience
Web search
When analyzing a known brand: search for "[product] features", "[product] vs competitors", company positioning — use to validate product connection, suggest missing features/use cases, and improve competitor gap analysis
If no product-marketing-context exists, infer from the article and optionally search for company/product info to enrich recommendations.
Research Phase: Keyword, Search Intent, Competitor (Required for Article Analysis)
Lightweight
research for article analysis—keyword extraction, intent check, competitor structure. For deep keyword research, topical mapping, or content planning, use
keyword-research
and
content-strategy
.
When
analyzing or auditing
an article, perform the following searches and
output the results
in the analysis. Skip only if user explicitly asks to skip (e.g. "skip search").
1. Keyword Search
Extract seed keywords
from article (title, H1, H2s, meta keywords, first 100 words).
Search the web
for related keywords and opportunity:
"[primary keyword]"
or
"[primary keyword] related keywords"
"[primary keyword]" site:competitor.com
(if competitors known)
Google autocomplete / "People also ask" style queries for the topic
Output
Primary keyword, secondary keywords, keyword opportunities (terms top rankers use that this article misses).
the blog index, category pages, or archive pages — see
blog-page-generator
for those
Initial Assessment
Check for product marketing context first:
If
.claude/product-marketing-context.md
or
.cursor/product-marketing-context.md
exists, read it for topics, audience, keywords, and Section 11 (Content/Blog/Article Strategy).
Identify:
Product connection
How does this article support the product? (educate on problem, introduce features, nurture leads)
Keyword basis
Target keyword from product context or keyword research — see
keyword-research
Content type
Blog post, guide, tutorial, news, evergreen
Length
Short (<1,000 words), medium (1,000–2,500), long (2,500+)
Intent
Informational, commercial, problem-aware
Product-linked content
Articles should tie to the product (problem it solves, features, use cases). Avoid purely generic content with no product relevance. Link to product/feature pages naturally in conclusion or when context fits.
Article Orientations
Not all articles share the same goal. Choose structure, SEO depth, and schema based on
Funding announcements, product updates, company news. Goal: brand, PR, existing audience. Don't expect rankings; focus on clarity, shareability, and internal linking to SEO content.
Hybrid
Product launch posts can include SEO-friendly sections (e.g., "How to use [feature]" with keyword targeting) while the main goal remains announcement.
Evergreen vs Timely Content
Attribute
Evergreen
Timely
Relevance
Year-round; foundational topics
Weeks to months; trends, news, seasonal
Traffic
Steady, compounds over time
Spikes then decline
Examples
"How to write a business plan," "Best SEO strategies"
. Too much evergreen = blog feels outdated; too much timely = irregular traffic, constant churn. Use timely content to link into evergreen pillar articles.
Date display
For timely content,
datePublished
matters more; for evergreen, prefer
dateModified
when visible (see Date Display below).
Competitor Article Analysis
Performed as part of
Research Phase
(see above). When competitor articles are obtained:
Obtain articles
URLs from user or product context (Section 11), or search web for
In Research Phase (Section 0) + add to Recommendations — structure to adopt, sections to add, length target, keyword opportunities, content gaps to fill
Article Page Structure
Section
Purpose
Hero/Header
Title (H1), author,
single date
(see Date Display below),
reading time
(word count ÷ 200; round up), featured image,
share buttons
TL;DR or Key Takeaways
Choose one:
TL;DR
= 50–100 word bold summary paragraph;
Key Takeaways
= 5–7 bullet points; placed after intro; supports GEO/AI citation
Introduction
40–120 words; hook in first 1–2 sentences (pain point, stat, or question); primary keyword in first 100 words; readers decide in ~8 seconds
Body
H2–H3 hierarchy; QAE pattern (see GEO below); scannable (lists, short paragraphs 40–80 words, visuals)