【note自動生成ツール】AIでブログ下書きを半自動作成（Gemini API対応・Windows用・初心者向け導入マニュアル付）

■ 本ツールの概要・目的

本ツールは、あなたのプロフィール（強み・実績等）とターゲットペルソナ（読者の悩み・言い訳）を基に、「一貫した論理展開」と「読者の共感を生むアプローチ」を両立した高品質なnote記事の下書きを自動生成するデスクトップアプリケーションです。

「AIに長文を書かせると、途中で内容がブレたり同じことを繰り返したりする」という悩みを解決するため、本システムでは独自の「3段階生成パイプライン」を採用しています。AIを一度だけ呼び出すのではなく、構成案作成から肉付けまでを段階的に行うことで、ブレのない圧倒的なクオリティの長文記事を生成します。

副業でのブログ運営やnote執筆の時間を劇的に短縮し、コンテンツの量産を強力にサポートします。

■ 本ツールの革新的な機能と仕様（選ばれる理由）

① 質の高い長文を生み出す「3段階生成パイプライン」

記事の生成はプログラム内部で以下の3ステップに分けて実行されます。

・第1段階（構成案の生成）：プロフィールやペルソナを基に、記事全体の章構成（プロット）を作成します。

・第2段階（各章の肉付け執筆）：自動分解された章ごとにAIへ執筆を指示。その際、前の章までに生成された本文全体の履歴（コンテキスト）を引き継ぐため、文脈が自然に繋がるループのない長文執筆を実現します。

・第3段階（仕上げ）：全章の本文をマージし、記事全体を最も惹きつける「タイトル」と「リード文（導入文）」を最後に生成します。

② 実績の捏造防止仕様（System Instruction準拠）

プロフィールに登録された「AIに厳守させたい実績」は、プロンプトの最優先ルールとしてAIに埋め込まれます。AIが勝手に架空の実績や嘘のストーリーを捏造することを防ぎ、実際のプロフィールと整合性の取れたリアルで説得力のある記事を作成させます。

③ 有料記事対応（有料ラインの自動挿入）

記事タイプを「有料（paid）」に設定すると、指定した章（デフォルトは第1章）の直後に「--- (有料ライン...) ---」という境界線文字列を自動挿入します。生成されたMarkdownファイルをnote編集画面にコピー＆ペーストする際、どこを有料部分にするか迷いません。

④ API制限（429エラー）の自動回避・再試行

Gemini API無料プランの制限（1分間に15リクエストまで）を回避する2つの防御壁を搭載。

・安全インターバル：API呼び出しが正常終了するごとに自動で13秒間待機（スリープ）します。

・指数バックオフ付き自動リトライ：万が一429エラーが発生しても、プログラムはクラッシュせずに一時停止。初回は25秒、その後は待機時間を1.5倍に増やしながら最大3回まで自動で再試行し、執筆を完了させます。

⑤ 設定ファイルおよびプロンプトの「自己修復仕様」

settings.yamlやプロンプトファイルがユーザーの誤操作で紛失・破損した場合でも、アプリ起動時または実行時にシステムが自動検知。内部のデフォルトデータを基に自動で新規作成して復元（自己修復）するため、アプリがクラッシュすることなく初期状態で自動復旧します。

⑥ Discord通知機能

設定したDiscord Webhook URLに対し、開始時（テーマ・切り口）、完了時（タイトル・保存先・概算文字数）、エラー発生時（具体的なエラーログ）のタイミングで通知をPOST送信します。

■ 技術スタック

・メインシステム: Python 3.11

・操作画面(GUI): Streamlit

・AIモデル: gemini-3.5-flash (Google AI Studio)

・設定・プロンプト形式: YAML (settings.yaml) および Markdown

・出力形式: Markdown (.md)

・外部通知: Discord Webhook

■ 導入から起動までの簡単4ステップ（Windowsユーザー向け）

パソコンの専門知識がない方でも、以下の手順通りに進めるだけで簡単に起動できます。

・STEP 1：ファイルの解凍（展開）

受け取ったZIPファイルを右クリックし、「すべて展開」で解凍します。※ZIPファイルを開いただけの状態で起動するとエラーの原因になります。

・STEP 2：アプリケーションの起動

フォルダ内の「note-generator.exe」をダブルクリックします。Windowsのセキュリティ保護画面が出た場合は、「詳細情報」をクリックして「実行」を押せば起動します。自動的にブラウザが開き、操作画面が表示されます。

・STEP 3：APIキーとプロフィールの登録

「マスター設定」タブを開き、Google AI Studioから取得した無料のGemini APIキー、ご自身のプロフィールやターゲットペルソナを入力して「設定を保存」を押します。

・STEP 4：記事の自動生成実行

「記事生成実行」タブでテーマと切り口を選び、「生成開始」ボタンを押すだけ！安全待機が入るため約2〜3分で風船が飛び、完成した記事のプレビューが表示されます。

■ 同梱ファイル（お届けするパッケージ内容）

ZIPファイルを解凍すると、以下のファイルが含まれています。

・note-generator.exe（アプリを起動するための実行ファイル本体）

・spec.md（ツールのシステム設計・動作仕様書）

・troubleshooting.md（トラブルシューティング・エラーハンドリングガイド）

・verify_stock_gui_flow.webp（マニュアル表示用のデモアニメーション映像）

※settings.yaml や prompts/ フォルダ内のプロンプトファイルは、初回起動時にシステムによって自動生成されますのでご安心ください。

■ ご購入後のサポートについて

当ショップでは、ご購入後もツールを末永くご活用いただけるよう、基本的な動作サポートをしっかりと丁寧に行う方針です。

初心者向けの「導入・使用マニュアル」および、万が一の際にもユーザー自身で手動対処できる方法をまとめた「トラブルシューティング・エラーハンドリングガイド」を同梱しておりますが、「マニュアル通りにやったのにうまく起動しない」「エラーコードが出て止まってしまった」といった場合は、ショップのメッセージ機能よりお気軽にお問い合わせください。解決まで親身にサポートいたします。

■ 注意事項

・本ツールの動作には、Google AI Studioから発行できる「Gemini APIキー（無料プランで取得可能）」が必須となります。事前のご準備をお願いいたします。

・個人開発の実行ファイル（未署名アプリ）の仕様上、初回起動時にWindowsのセキュリティ警告が出ますが、OSの仕様によるものでウイルスや不具合ではございません。マニュアルの手順に沿って「実行」を行ってください。

・プロンプト（AIへの指示文）は外部のMarkdownファイルとして自由にカスタマイズ可能ですが、{ROLE} などの波括弧（差し替え用マーカー）を削除・改変するとシステムエラー（KeyError）が発生しますのでご注意ください。