agri-ja 日本の農業政策・補助金・米の概算金 MCP server

農業情報メディア（nogyo-media）

Next.js 15（App Router）＋ TypeScript ＋ Tailwind CSS v4 で構築した農業情報メディアの静的サイトです。記事本文は content/articles/.md の frontmatter と HTML 本文で管理します。Git リモートは GitHub** を想定しています（Vercel の Git 連携とも相性がよいです）。

メディア方針・未決バックログ・SEOメモは docs/メディア方針と実装メモ.md にまとめています（実装・運用時の参照用）。

はじめての公開まで（ほぼ自動）

ターミナルでこのフォルダに移動できる前提です。あなたが用意するのは 名前・メール・GitHub のトークン だけです（トークンは GitHub に一度も載せない でください）。

1. 設定ファイルを作る（例にコピーして編集）

cd nogyo-media
   cp setup.secrets.env.example setup.secrets.env

setup.secrets.env を開き、GITUSERNAME・GITUSEREMAIL・GH_TOKEN を埋めます。

• GHTOKEN** … GitHub → Settings → Developer settings → Personal access tokens で作成（リポジトリへの push ができる権限が必要です）。
• トークンの代わりに GitHub CLI で gh auth login 済みなら、GH_TOKEN を空にしても push できます。

1. 初回の Git 設定・コミット・GitHub へ push を一括実行

npm run setup:first-push

setup.secrets.env に VERCEL_TOKEN=...（Vercel → Account Settings → Tokens）を追加し:

1. （任意）Vercel をトークンだけで先に本番に出す

npm run setup:vercel

Vercel で New Project → さきほどの GitHub リポジトリを Import（Root Directory は空のまま）。これで 2回目以降は git push だけでデプロイされます。

1. push のたびに自動で本番更新したい場合（おすすめ）

注意: setup.secrets.env は .gitignore 済みです。絶対にコミット・共有しないでください。 漏れたらトークンはすぐ無効化し、作り直してください。

記事化開始→確認→WEB公開（標準フロー）

microCMS は使わず、ファイルベースのみで公開します。

0) 元PDFを置く

記事作成/記事化入力/ に元PDFを置きます。

1) チャット指示で記事化開始（またはコマンド）

チャットで「このPDFを記事化開始」と指示するか、nogyo-media で次を実行します。

npm run article:start -- "../記事化入力/<ファイル名>.pdf"

実行すると次が作られます。

• 記事/元資料/記事と元資料/<ファイル名>/
• 同フォルダ内に元PDFコピー
• 同フォルダ内に <ファイル名>_解説記事.html（雛形）
• 同フォルダ内に <ファイル名>_作業メモ.md

2) 記事を作成して確認する

記事/元資料/記事と元資料/<ファイル名>/<ファイル名>_解説記事.html を完成させ、内容を確認します。

補足:

• ページ上部の タイトル / 日付 / タグ / 読了目安 / 目次 / 共有操作 はサイト側で共通表示されます。
• HTML本文側では 内に本文を記述し、 や先頭 は原則不要です（重複表示を避けるため）。
• 記事生成時のルールは docs/記事生成プロンプト.md を必ず参照してください。
• data:image / Base64画像 / SVGの data URI はそのまま公開しません。Google が読む HTML を極端に肥大化させるため、公開時には外部画像へ変換・軽量化します。

3) 確認OK後にWEB用ファイルを生成する

npm run article:stage -- "../記事/元資料/記事と元資料/<ファイル名>" <slug>

例:

npm run article:stage -- "../記事/元資料/記事と元資料/25_物流革新に向けた取組の推進" logistics-innovation-promotion

このコマンドで次を作成/更新します。

• content/source-html/.html
• content/articles/.md（sourceHtmlFile 参照型）

補足:

• stage-article-for-web.sh は、HTML 内の data:image やローカル画像を public/article-images// に書き出し、HTML の src を公開用パスへ差し替えます。
• CSS の url(data:...) は変換対象外のため、含まれている場合はエラーで停止します。
• 図版そのものは禁止ではありません。禁止しているのは HTML への画像バイナリ埋め込みを、そのまま公開すること です。
• 公開図版は PNG を既定とします（prepare-article-assets.py）。AVIF は環境によってデコードされず真っ白になることがあるため、public/article-images//.avif と source-html 内の .avif 参照は npm run build 前の検証で失敗します。
• PDF・公式スライドの図版は、スライド内の一部を切り抜かず、該当ページ（スライド）を1枚まるごと画像化して掲載します（1 PDF ページ＝原則 1 画像）。再現用に scripts/render-pdf-page-to-png.py（要 pymupdf）があります。

4) 最後に公開する（手動）

公開は コミット と push の2段階に分かれています。article:publish はコミットまでで止まり、push しません。

npm run article:publish -- <slug>   # 1記事=1コミット。push はしない
npm run article:push -- --dry       # 溜まっているコミットの内容を表示（push しない）
npm run article:push                # その日の分をまとめて1回だけ push

publish-article.sh は content/articles/.md に加えて、sourceHtmlFile が指定されている場合は対応する content/source-html/.html も一緒にコミットします。あわせて 記事一覧 CSV**（public/articles-index.csv）も再生成してコミットし、最後に未 push のコミット数を表示します。

push は1日1回にまとめてください。 Vercel の課金は読者のアクセス量ではなく push 回数（ビルドCPU時間） でほぼ決まります（1 push ≈ $0.14、Pro の月間クレジットは $20）。記事を3本出す日も、コミットを3つ積んでから最後に npm run article:push を1回だけ実行します。「1記事=1コミット」は revert しやすさのために維持し、push だけをまとめるのが原則です。使い切るとサイトが停止します（2026-08-10 に実際に3日22時間停止）。

なお push を実行してよいのは、ユーザーから「push して」「公開して」と明示的に指示があったときだけです。指示がなければコミットまでで止め、「公開待ち」として報告します。

push したら、その場で台帳とVercelを確認する

Shortened. The full README is on GitHub.