@telepat/ideon 0.1.31 → 0.1.33

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.de.md ADDED
@@ -0,0 +1,121 @@
1
+ <p align="center"><img src="./assets/avatar/ideon-logo.webp" width="128" alt="Ideon"></p>
2
+ <h1 align="center">Ideon</h1>
3
+ <p align="center"><em>Verwandle eine Idee in Artikel, Threads und Social-Media-Beiträge. Hochwertige Inhalte ohne Token-Overhead.</em></p>
4
+
5
+ <p align="center">
6
+ <a href="https://docs.telepat.io/ideon">📖 Docs</a>
7
+ · <a href="./README.md">🇺🇸 English</a>
8
+ · <a href="./README.zh-CN.md">🇨🇳 简体中文</a>
9
+ · <a href="./README.de.md">🇩🇪 Deutsch</a>
10
+ </p>
11
+
12
+ <p align="center">
13
+ <a href="https://github.com/telepat-io/ideon/actions/workflows/ci.yml"><img src="https://github.com/telepat-io/ideon/actions/workflows/ci.yml/badge.svg?branch=main" alt="Build"></a>
14
+ <a href="https://codecov.io/gh/telepat-io/ideon"><img src="https://codecov.io/gh/telepat-io/ideon/graph/badge.svg" alt="Codecov"></a>
15
+ <a href="https://www.npmjs.com/package/@telepat/ideon"><img src="https://img.shields.io/npm/v/@telepat/ideon" alt="npm"></a>
16
+ <a href="https://github.com/telepat-io/ideon/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-yellow.svg" alt="License"></a>
17
+ </p>
18
+
19
+ Ideon ist ein KI-Content-Writer, der eine einzige Idee in veröffentlichungsreife Inhalte in verschiedenen Formaten, Stilen und Kanälen umwandelt. Beschreiben Sie Ihr Thema einmal und Ideon erzeugt einen Artikel sowie X-Threads, LinkedIn-Posts, Reddit-Posts, Newsletter und Blogbeiträge – alle mit einer einheitlichen Stimme und Strategie.
20
+
21
+ Entwickelt für Marketer, Gründer und schlanke Teams, die hochwertige Inhalte in großem Umfang bereitstellen müssen, ohne eine Idee für jeden Kanal manuell umzuschreiben.
22
+
23
+ ## Features
24
+
25
+ - **Einmal schreiben, überall veröffentlichen** — Eine Idee wird in einem einzigen Durchlauf zu Artikel, Blog, Newsletter, X-, LinkedIn- und Reddit-Posts. Der Artikel bildet das Fundament der Kampagne. Alles andere dient seiner Verbreitung.
26
+ - **Stil- und Intent-Steuerung** — 13 Stile × 13 Intents. Jedes Ergebnis teilt eine konsistente Stimme über alle Kanäle hinweg.
27
+ - **Recherchegestützte Links** — Ideon durchsucht das Web und fügt kontextbezogene externe Links ein, wie es ein menschlicher Autor tun würde. Keine manuelle Recherche.
28
+ - **SEO-optimierte Ausgabe** — On-Page-SEO, E-E-A-T-Glaubwürdigkeitssignale und Fakten-Dichte sind in die Schreib-Pipeline integriert. Inhalte, die sowohl in der klassischen Suche als auch in KI-generierten Zusammenfassungen ranken.
29
+ - **Beliebiges Modell via OpenRouter** — Nutzen Sie Claude, GPT-4 oder jedes unterstützte Modell. Wechseln Sie ohne Änderung Ihres Workflows.
30
+ - **Anleitunggestütztes Schreiben** — Prompt-Komposition basierend auf bewährten Schreibprinzipien, zusammengestellt aus echter Beratungspraxis. Kein generischer KI-Füllstoff.
31
+ - **Code-gesteuerte Effizienz** — Eine deterministische Pipeline übernimmt die Orchestrierung. Sie zahlen Tokens nur für die Textgenerierung.
32
+ - **Visuelles Storytelling** — Automatisch generierte Cover- und Inline-Bilder via Replicate für artikelgeführte Durchläufe.
33
+ - **Agent- und CI-fähig** — MCP-Server, nicht-interaktiver Modus, maschinenlesbare Konfiguration und fortsetzbare Durchläufe.
34
+ - **Google Keyword Planner** — Reale Keyword-Daten von Google Ads abrufen: Ideen, historische Metriken und Prognosen. Einrichtung mit `ideon gads login`, Abfrage mit `ideon gkp`.
35
+
36
+ ## Quick Start
37
+
38
+ Installieren und erstes Content-Set generieren:
39
+
40
+ ```bash
41
+ npm i -g @telepat/ideon
42
+ ideon settings
43
+ ideon write "How small editorial teams can productionize AI writing" --primary article=1 --secondary x-post=1
44
+ ideon preview
45
+ ```
46
+
47
+ Erwartetes Ergebnis:
48
+
49
+ - Ein Generierungsordner wird unter `output/<timestamp>-<slug>/` angelegt.
50
+ - Eine oder mehrere veröffentlichungsreife Markdown-Ausgaben werden erzeugt.
51
+ - Analyse- und Metadaten-Artefakte werden für Überprüfung und Reproduzierbarkeit gespeichert.
52
+ - Die lokale Vorschau öffnet sich zur Prüfung von Inhalten, Links und generierten Assets.
53
+
54
+ ## Requirements
55
+
56
+ - Node.js 20+
57
+ - npm 10+
58
+ - OpenRouter API-Key
59
+ - Replicate API-Token
60
+
61
+ ## How It Works
62
+
63
+ Ideon durchläuft eine gestufte Schreib-Pipeline: Planung, Entwurf, Bild-Prompt-Erweiterung, Bildgenerierung, Kanalausgabeerzeugung und optionale Link-Anreicherung.
64
+
65
+ Es kombiniert Konfiguration aus Einstellungen, Umgebungsvariablen, Job-Dateien und CLI-Flags und schreibt strukturierte Artefakte für Nachvollziehbarkeit und Wiederverwendung.
66
+
67
+ Core commands:
68
+
69
+ ```bash
70
+ ideon settings
71
+ ideon config list --json
72
+ ideon write "An article idea" --primary article=1
73
+ ideon write --no-interactive --idea "An article idea" --primary article=1 --style technical --length medium
74
+ ideon write --job ./job.json
75
+ ideon write resume
76
+ ideon delete my-article-slug
77
+ ideon preview --no-open
78
+ ideon gads login
79
+ ideon gkp ideas --keywords seo,marketing
80
+ ```
81
+
82
+ ## Using With AI Agents
83
+
84
+ Ideon ist für agentische Workflows konzipiert:
85
+
86
+ - **MCP-Server** — `ideon mcp serve` stellt Tools über stdio bereit für Content-Generierung, Fortsetzung, Löschung, Konfigurationsverwaltung und Google Keyword Planner-Abfragen. Kompatibel mit Claude Code, ChatGPT, Gemini und jedem generischen MCP-Host.
87
+ - **Agent-Runtime-Registrierung** — `ideon agent install <runtime>` registriert Integrationsprofile für unterstützte Plattformen. Status prüfen mit `ideon agent status --json`.
88
+ - **Nicht-interaktiver Modus** — `ideon write --no-interactive ...` entfernt alle Prompts für CI und Automatisierung.
89
+ - **Maschinenlesbare Konfiguration** — `ideon config list --json` und `ideon config get <key> --json` für Agent-Inspektion.
90
+ - **Skill-Paket** — Installieren Sie `skill/ideon-cli/` in Ihren Agent-Host für einen vollständigen Lifecycle-Skill, der Installation, Einrichtung, Betrieb und Debugging abdeckt.
91
+ - **Agent-Dokumentation** — [For Agents](https://docs.telepat.io/ideon/for-agents) behandelt MCP-Server, Skills und Wartung.
92
+
93
+ ## Security And Trust
94
+
95
+ - Secrets werden standardmäßig über `ideon settings` im OS-Keychain gespeichert.
96
+ - In CI- oder containerisierten Umgebungen nutzen Sie `TELEPAT_OPENROUTER_KEY` und `TELEPAT_REPLICATE_TOKEN`.
97
+ - Setzen Sie `TELEPAT_DISABLE_KEYTAR=true`, wenn kein Keychain-Zugriff verfügbar ist.
98
+ - Generierte Ausgaben können modellgenerierte Inhalte enthalten – prüfen Sie Inhalte vor der Veröffentlichung.
99
+
100
+ Um ein Sicherheitsproblem zu melden, öffnen Sie eine private Meldung über den Security-Workflow des Repositorys oder kontaktieren Sie die Maintainer über die Issue-Kanäle des Repositorys mit minimalen sensiblen Details.
101
+
102
+ ## Documentation And Support
103
+
104
+ - [Documentation site](https://docs.telepat.io/ideon)
105
+ - [Quickstart](https://docs.telepat.io/ideon/getting-started/quickstart)
106
+ - [CLI reference](https://docs.telepat.io/ideon/reference/cli-reference)
107
+ - [Configuration guide](https://docs.telepat.io/ideon/guides/configuration)
108
+ - [Troubleshooting](https://docs.telepat.io/ideon/guides/troubleshooting)
109
+ - [For Agents](https://docs.telepat.io/ideon/for-agents)
110
+ - [Repository](https://github.com/telepat-io/ideon)
111
+ - [npm package](https://www.npmjs.com/package/@telepat/ideon)
112
+
113
+ ## Contributing
114
+
115
+ Beiträge sind willkommen. Beginnen Sie mit [Development](https://docs.telepat.io/ideon/contributing/development) für Einrichtung, Workflow und Qualitätsgates, und folgen Sie dann [Releasing and Docs Deploy](https://docs.telepat.io/ideon/contributing/releasing-and-docs-deploy) für Details zu Release und Dokumentations-Deployment.
116
+
117
+ Bei Änderungen an der benutzerorientierten Dokumentation aktualisieren Sie sowohl englische als auch vereinfachte chinesische Inhalte in derselben Änderung.
118
+
119
+ ## License
120
+
121
+ MIT. Siehe [LICENSE](./LICENSE).
package/README.md CHANGED
@@ -6,6 +6,7 @@
6
6
  <a href="https://docs.telepat.io/ideon">📖 Docs</a>
7
7
  · <a href="./README.md">🇺🇸 English</a>
8
8
  · <a href="./README.zh-CN.md">🇨🇳 简体中文</a>
9
+ · <a href="./README.de.md">🇩🇪 Deutsch</a>
9
10
  </p>
10
11
 
11
12
  <p align="center">
@@ -24,11 +25,13 @@ Built for marketers, founders, and lean teams who need to ship high-quality cont
24
25
  - **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.
25
26
  - **Style and intent control** — 13 styles × 13 intents. Every output shares one consistent voice across every channel.
26
27
  - **Research-backed links** — Ideon browses the web and inserts contextual external links like a human writer would. No manual research.
28
+ - **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.
27
29
  - **Any model via OpenRouter** — Plug in Claude, GPT-4, or any supported model. Switch without changing your workflow.
28
30
  - **Writing guide-driven** — Prompt composition grounded in proven writing principles compiled from real advice. No generic AI filler.
29
31
  - **Code-driven efficiency** — Deterministic pipeline code handles orchestration. You pay for tokens only when drafting prose.
30
32
  - **Visual storytelling** — Auto-generated cover and inline images via Replicate for article-led runs.
31
33
  - **Agent and CI ready** — MCP server, non-interactive mode, machine-readable config, and resumable runs.
34
+ - **Google Keyword Planner** — Query real keyword data from Google Ads: ideas, historical metrics, and forecasts. Set up with `ideon gads login`, query with `ideon gkp`.
32
35
 
33
36
  ## Quick Start
34
37
 
@@ -72,13 +75,15 @@ ideon write --job ./job.json
72
75
  ideon write resume
73
76
  ideon delete my-article-slug
74
77
  ideon preview --no-open
78
+ ideon gads login
79
+ ideon gkp ideas --keywords seo,marketing
75
80
  ```
76
81
 
77
82
  ## Using With AI Agents
78
83
 
79
84
  Ideon is built for agentic workflows:
80
85
 
81
- - **MCP server** — `ideon mcp serve` exposes 5 tools over stdio for content generation, resume, deletion, and config management. Compatible with Claude Code, ChatGPT, Gemini, and any generic MCP host.
86
+ - **MCP server** — `ideon mcp serve` exposes tools over stdio for content generation, resume, deletion, config management, and Google Keyword Planner queries. Compatible with Claude Code, ChatGPT, Gemini, and any generic MCP host.
82
87
  - **Agent runtime registration** — `ideon agent install <runtime>` registers integration profiles for supported platforms. Check status with `ideon agent status --json`.
83
88
  - **Non-interactive mode** — `ideon write --no-interactive ...` removes all prompts for CI and automation.
84
89
  - **Machine-readable config** — `ideon config list --json` and `ideon config get <key> --json` for agent inspection.
@@ -88,8 +93,8 @@ Ideon is built for agentic workflows:
88
93
  ## Security And Trust
89
94
 
90
95
  - Secrets are stored in the OS keychain by default via `ideon settings`.
91
- - In CI or containerized environments, use `IDEON_OPENROUTER_API_KEY` and `IDEON_REPLICATE_API_TOKEN`.
92
- - Set `IDEON_DISABLE_KEYTAR=true` when keychain access is unavailable.
96
+ - In CI or containerized environments, use `TELEPAT_OPENROUTER_KEY` and `TELEPAT_REPLICATE_TOKEN`.
97
+ - Set `TELEPAT_DISABLE_KEYTAR=true` when keychain access is unavailable.
93
98
  - Generated outputs can include model-produced content, so review content before publication.
94
99
 
95
100
  To report a security issue, open a private report through the repository security flow or contact maintainers through repository issue channels with minimal sensitive detail.
package/README.zh-CN.md CHANGED
@@ -6,6 +6,7 @@
6
6
  <a href="https://docs.telepat.io/ideon">📖 文档</a>
7
7
  · <a href="./README.md">🇺🇸 English</a>
8
8
  · <a href="./README.zh-CN.md">🇨🇳 简体中文</a>
9
+ · <a href="./README.de.md">🇩🇪 Deutsch</a>
9
10
  </p>
10
11
 
11
12
  <p align="center">
@@ -24,6 +25,7 @@ Ideon 是一款 AI 内容写作工具,可将一个想法转化为多格式、
24
25
  - **写一次,处处发布** — 一次运行将一个创意转化为文章、博客、新闻通讯、X、LinkedIn 和 Reddit 帖子。文章是核心,其余均为推广内容。
25
26
  - **风格与意图控制** — 13 种风格 × 13 种意图。所有输出共享同一种一致的声音。
26
27
  - **研究支撑的链接** — Ideon 浏览网络并像人类作者一样插入与上下文相关的外部链接。无需手动研究。
28
+ - **SEO 优化输出** — 页面 SEO、E-E-A-T 可信度信号和事实密度已融入写作流水线。生成的内容针对传统搜索和 AI 生成摘要进行了排名优化。
27
29
  - **通过 OpenRouter 接入任何模型** — 接入 Claude、GPT-4 或任何支持的模型。无需更改工作流程即可切换。
28
30
  - **写作指南驱动** — 提示词组合基于经过实践检验的写作原则汇编而成。没有通用 AI 套话。
29
31
  - **代码驱动的高效率** — 确定性流水线代码处理编排。您只需在起草正文时支付 token 费用。
@@ -88,8 +90,8 @@ Ideon 专为智能体工作流打造:
88
90
  ## 安全与信任
89
91
 
90
92
  - 默认通过 `ideon settings` 将密钥保存到系统钥匙串。
91
- - 在 CI 或容器环境中,请使用 `IDEON_OPENROUTER_API_KEY` 和 `IDEON_REPLICATE_API_TOKEN`。
92
- - 在无法访问钥匙串时设置 `IDEON_DISABLE_KEYTAR=true`。
93
+ - 在 CI 或容器环境中,请使用 `TELEPAT_OPENROUTER_KEY` 和 `TELEPAT_REPLICATE_TOKEN`。
94
+ - 在无法访问钥匙串时设置 `TELEPAT_DISABLE_KEYTAR=true`。
93
95
  - 生成内容来自模型输出,发布前请进行人工审阅。
94
96
 
95
97
  如需报告安全问题,请通过仓库安全报告通道私下提交,或通过仓库 issue 渠道联系维护者并避免包含敏感细节。