`gtm-toolkit analyze`

Invoke Claude to review your content strategy, find keyword opportunities, and generate competitor insights.

The CLI does not ship a generic --ai flag; use the focused modes like --keywords, --competitor, or --gaps depending on the analysis you need.

Requirements
Configure AI access before running the command
  • • Set CLAUDE_API_KEY in your environment (local shell or CI secrets).
  • • Confirm outbound network access in CI if you run this command automatically.
Usage
Different analysis modes tailored to common workflows
--competitor <url>
Review a competitor website and compare content pillars
--gaps
Scan your own markdown files for missing coverage
--keywords <topic>
Generate a structured keyword list for a topic
--output <file>
Persist results as JSON for later processing
Sample Keyword Output
Structured JSON that can feed directly into briefs or spreadsheets
{
  "topic": "gtm as code",
  "primary": [
    { "keyword": "gtm as code", "intent": "informational", "difficulty": 32 },
    { "keyword": "marketing engineering playbook", "intent": "informational", "difficulty": 27 }
  ],
  "supporting": [
    { "keyword": "continuous marketing delivery", "intent": "informational" },
    { "keyword": "developer native marketing", "intent": "informational" }
  ]
}
Pro Tips
Get more signal from your Claude-powered analysis
  • • Pair --gaps with --output and store results in version control for trend tracking.
  • • Combine competitor runs with gtm-toolkit lint results to spot structural deltas quickly.
  • • Redirect output to a file (e.g., --output competitor.json) so you can diff changes over time.