content_analyze

Analyze a piece of content using AI. Returns structured breakdown including hooks, main points, call-to-action, and writing style.

Parameters

Parameter	Type	Required	Description
`contentId`	string (UUID)	Yes	Content ID from digest_list or vault

Example

Prompt

Analyze that Naval tweet about specific knowledge

Response

{
  "contentId": "content_abc123",
  "analysis": {
    "hook": {
      "type": "curiosity",
      "text": "Specific knowledge is knowledge you cannot be trained for.",
      "effectiveness": "high",
      "notes": "Opens with a counterintuitive statement that challenges conventional wisdom about education and training."
    },
    "structure": {
      "format": "single_insight",
      "pattern": "statement → implication",
      "length": "short",
      "readabilityScore": 92
    },
    "mainPoints": [
      "Specific knowledge cannot be taught through traditional training",
      "If knowledge can be standardized, you become replaceable",
      "Value comes from unique, non-commoditized skills"
    ],
    "cta": {
      "present": false,
      "type": null,
      "text": null
    },
    "writingStyle": {
      "tone": "philosophical",
      "voice": "authoritative",
      "techniques": [
        "aphoristic",
        "logical_chain",
        "implied_threat"
      ],
      "vocabulary": "simple"
    },
    "engagement": {
      "emotionalTriggers": ["fear_of_replacement", "desire_for_uniqueness"],
      "shareability": "high",
      "targetAudience": "knowledge_workers",
      "viralPotential": 8.5
    },
    "suggestions": [
      "This format works well for establishing thought leadership",
      "The 'if X then Y' structure creates logical inevitability",
      "Could be expanded into a thread exploring types of specific knowledge"
    ]
  },
  "tokensUsed": 1250
}

Response Fields

hook

Field	Description
`type`	Hook type: curiosity, controversy, story, question, statistic
`text`	The hook text extracted from content
`effectiveness`	Rating: low, medium, high
`notes`	Explanation of why it works

structure

Field	Description
`format`	single_insight, listicle, story, thread, how_to
`pattern`	Content flow pattern
`length`	short, medium, long
`readabilityScore`	Flesch readability score (0-100)

writingStyle

Field	Description
`tone`	philosophical, casual, urgent, inspirational, etc.
`voice`	authoritative, friendly, provocative, etc.
`techniques`	Array of writing techniques used
`vocabulary`	simple, moderate, advanced

engagement

Field	Description
`emotionalTriggers`	Emotions the content targets
`shareability`	low, medium, high
`targetAudience`	Primary audience segment
`viralPotential`	Score from 1-10

Token Usage

Analysis uses AI tokens from your monthly allowance. The tokensUsed field shows consumption per analysis. Check your limits with workspace_stats.

Use Cases

Learn what makes high-performing content work
Extract hooks and structures to adapt for your own content
Study writing techniques from creators you admire
Get actionable suggestions for content improvement