---
ownerAgent: e064dca9e1bd
name: seo-content
description_zh: "对 seo-crawl 抽取的正文做启发式内容质量与 GEO 就绪度诊断：AI 腔/填充词、统计声明无引用、答案是否前置、句子过长、标题与正文不一致，输出 content 维度 findings；适合\"看看这页内容质量\"\"内容有没有 AI 味、答案前不前置\"；触发词：内容质量、E-E-A-T、AI 腔、引用缺口、答案前置、可读性"
description_en: "Heuristic content-quality & GEO-readiness findings over seo-crawl text: AI/filler tone, uncited statistical claims, answer-first placement, over-long sentences, title↔body mismatch; emits content-dimension findings; For: 'check this page's content quality', 'is the content AI-sounding / answer front-loaded'; Triggers: content quality, E-E-A-T, AI tone, citation gap, answer-first, readability"
category: data
---

# seo-content

Heuristic content/GEO-readiness analysis of the visible text from `seo-crawl`. No network. Judgments are heuristic (marked Estimated); raw counts are Measured.

## When to use

- The diagnose flow wants content-quality + GEO-readiness findings alongside the technical audit.
- Pre-publish check for AI tone / uncited claims / answer-first before writing or shipping content.

## When NOT to use

- Technical SEO (indexability/meta/headings) — that is `seo-tech-audit`.
- Rewriting content — the agent's LLM does that in content mode; this only scores/flags.
- Anything needing the full DOM or JS-rendered text (works on the crawl's `text_sample`).

## Preconditions

- A `seo-crawl` JSON whose page includes `text_sample` (the crawler provides it). Python 3.9+ stdlib only.

## How to call

```
"$ORKAS_NODE" "$ORKAS_PC_DIR/bin/run-skill.cjs" seo-content content -- --input <crawl.json> [--out <content.json>]
```

`--input` seo-crawl JSON (omit/`-` for stdin); `--out` optional file.

## Expected output

```json
{ "ok": true, "data": {
  "content_score": 88,
  "findings": [ { "id": "ai_tone", "dimension": "content", "severity": "medium",
                  "evidence": "...", "recommendation": "...", "leading_indicator": "...",
                  "failure_criterion": "...", "data_tier": "Estimated" } ],
  "summary": { "total": 1 },
  "meta": { "url": "...", "claims_detected": 0, "ai_phrase_hits": 0, "avg_sentence_words": 0.0, "word_count": 0 } } }
```

Findings use `dimension: "content"` and feed `seo-report --add`. Failure: `{"ok": false, "error": "..."}` on stderr, non-zero exit.

## Heuristics (deterministic)

- **ai_tone**: ≥3 filler/cliché phrases (delve, leverage the power, cutting-edge, …).
- **uncited_claims**: ≥3 statistic/quantity/authority/year claims with 0 outbound links.
- **no_answer_first**: ≥150 words but the opening paragraph is <60 chars (answer not front-loaded — GEO).
- **long_sentences**: average >30 words/sentence.
- **title_body_mismatch**: no significant title term appears in the H1/opening.