@telepat/ideon 0.1.31 → 0.1.32

package/README.md

@@ -24,6 +24,7 @@ Built for marketers, founders, and lean teams who need to ship high-quality cont
 - **Write once, publish everywhere** — One idea turns into article, blog, newsletter, X, LinkedIn, and Reddit posts in a single run. Your article anchors the campaign. Everything else promotes it.
 - **Style and intent control** — 13 styles × 13 intents. Every output shares one consistent voice across every channel.
 - **Research-backed links** — Ideon browses the web and inserts contextual external links like a human writer would. No manual research.
+- **SEO-optimized output** — On-page SEO, E-E-A-T credibility signals, and fact density baked into the writing pipeline. Content built to rank in both traditional search and AI-generated summaries.
 - **Any model via OpenRouter** — Plug in Claude, GPT-4, or any supported model. Switch without changing your workflow.
 - **Writing guide-driven** — Prompt composition grounded in proven writing principles compiled from real advice. No generic AI filler.
 - **Code-driven efficiency** — Deterministic pipeline code handles orchestration. You pay for tokens only when drafting prose.

package/README.zh-CN.md

@@ -24,6 +24,7 @@ Ideon 是一款 AI 内容写作工具，可将一个想法转化为多格式、
 - **写一次，处处发布** — 一次运行将一个创意转化为文章、博客、新闻通讯、X、LinkedIn 和 Reddit 帖子。文章是核心，其余均为推广内容。
 - **风格与意图控制** — 13 种风格 × 13 种意图。所有输出共享同一种一致的声音。
 - **研究支撑的链接** — Ideon 浏览网络并像人类作者一样插入与上下文相关的外部链接。无需手动研究。
+- **SEO 优化输出** — 页面 SEO、E-E-A-T 可信度信号和事实密度已融入写作流水线。生成的内容针对传统搜索和 AI 生成摘要进行了排名优化。
 - **通过 OpenRouter 接入任何模型** — 接入 Claude、GPT-4 或任何支持的模型。无需更改工作流程即可切换。
 - **写作指南驱动** — 提示词组合基于经过实践检验的写作原则汇编而成。没有通用 AI 套话。
 - **代码驱动的高效率** — 确定性流水线代码处理编排。您只需在起草正文时支付 token 费用。

package/dist/ideon.js

@@ -1428,7 +1428,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 // package.json
 var package_default = {
   name: "@telepat/ideon",
-  version: "0.1.31",
+  version: "0.1.32",
   description: "CLI for generating rich articles and images from ideas.",
   type: "module",
   repository: {
@@ -2064,6 +2064,9 @@ function intentToGuidePath(intent) {
 function styleToGuidePath(style) {
   return `writing-guide/styles/${style}.md`;
 }
+function seoGuidePath(name) {
+  return `writing-guide/seo/${name}.md`;
+}
 function dedupe(items) {
   return Array.from(new Set(items));
 }
@@ -2079,6 +2082,7 @@ function buildPrimaryPlanGuideInstruction(intent, contentType) {
     "writing-guide/references/headline-writing-systems.md",
     "writing-guide/references/ideation-and-credibility-systems.md",
     "writing-guide/references/content-frameworks.md",
+    seoGuidePath("on-page-essentials"),
     intentToGuidePath(intent),
     formatToGuidePath(contentType)
   ];
@@ -2098,6 +2102,9 @@ function buildArticleSectionGuideInstruction(style, intent, contentType) {
     "writing-guide/references/prose-quality-checks.md",
     "writing-guide/references/readability-and-pace.md",
     "writing-guide/references/skimmability-patterns.md",
+    seoGuidePath("on-page-essentials"),
+    seoGuidePath("eeat-signals"),
+    seoGuidePath("fact-density"),
     styleToGuidePath(style),
     intentToGuidePath(intent),
     formatToGuidePath(contentType)
@@ -2445,9 +2452,9 @@ function buildLongFormPlanMessages(idea, options) {
         "",
         "Requirements:",
         "- The content should feel authoritative, practical, and clearly structured for scanning and deep reading.",
-        "- Generate a memorable title and a sharp subtitle that promise a concrete benefit, mechanism, or outcome.",
+        "- Generate a memorable title (under 60 characters) that leads with the primary entity. Include a sharp subtitle that promises a concrete benefit, mechanism, or outcome.",
         "- The slug must be lowercase kebab-case and publication-ready.",
-        "- The description should work as a concise meta description and align with the shared content plan.",
+        "- The description should work as a concise meta description (120-160 characters), include the primary entity, and align with the shared content plan.",
         `- Plan ${sectionCounts.label} strong sections with distinct focus areas and logical progression (no repetitive section intent).`,
         "- Frame section titles to reflect likely search intent or practical reader questions when appropriate.",
         "- Each section description should name the mechanism, evidence type, or practical action that makes the section useful.",
@@ -2468,7 +2475,7 @@ function buildLongFormPlanMessages(idea, options) {
         `- contentType: set to "${options.contentType}" exactly`,
         "- title: string",
         "- subtitle: string",
-        "- keywords: array of 3 to 8 strings",
+        "- keywords: array of 3 to 8 specific, non-generic strings representing primary entities and search topics (not exact-match duplicates of heading text)",
         "- slug: string in lowercase kebab-case",
         "- description: string",
         "- introBrief: string",
@@ -2615,6 +2622,30 @@ async function planPrimaryContent({
       return shortFormPlanSchema.parse(data);
     }
   });
+  if (!dryRun) {
+    const seoWarnings = [];
+    if (basePlan.title && basePlan.title.length > 60) {
+      seoWarnings.push(`Title is ${basePlan.title.length} chars (recommended: under 60 for search display safety)`);
+    }
+    if (basePlan.description) {
+      if (basePlan.description.length < 120) {
+        seoWarnings.push(`Description is ${basePlan.description.length} chars (recommended: 120-160 for meta description effectiveness)`);
+      } else if (basePlan.description.length > 160) {
+        seoWarnings.push(`Description is ${basePlan.description.length} chars (recommended: 120-160 for meta description effectiveness)`);
+      }
+    }
+    if (isLongForm) {
+      const longPlan = basePlan;
+      const headings = longPlan.sections.map((s) => s.title.toLowerCase());
+      const duplicateKeywords = longPlan.keywords.filter((kw) => headings.includes(kw.toLowerCase()));
+      if (duplicateKeywords.length > 0) {
+        seoWarnings.push(`Keywords duplicate heading text: ${duplicateKeywords.join(", ")} (consider using semantic variants)`);
+      }
+    }
+    for (const warning of seoWarnings) {
+      console.warn(`[seo] ${warning}`);
+    }
+  }
   const normalizedSlug = slugify(basePlan.slug || basePlan.title);
   const uniqueSlug = await resolveUniqueSlug(markdownOutputDir, normalizedSlug);
   if (isLongForm) {
@@ -2949,7 +2980,8 @@ function buildSectionMessages(plan, section, articleSoFar, style, intent, conten
         "Requirements:",
         `- ${paragraphCount} paragraphs.`,
         `- Target length: about ${sectionTargetWords} words.`,
-        "- Be concrete and specific.",
+        "- Be concrete and specific. Support key claims with statistics, data points, or authoritative citations.",
+        "- Include at least one practical insight that sounds like first-hand practitioner experience.",
         "- Continue naturally from the article draft so far without rehashing prior sections.",
         "- Use short Markdown lists only if they materially improve clarity."
       ].join("\n")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telepat/ideon",
-  "version": "0.1.31",
+  "version": "0.1.32",
   "description": "CLI for generating rich articles and images from ideas.",
   "type": "module",
   "repository": {