The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Agri Ja 日本の農業政策・補助金・米の概算金 listing page.
Next.js 15（App Router）＋ TypeScript ＋ Tailwind CSS v4 で構築した農業情報メディアの静的サイトです。記事本文は content/articles/*.md の frontmatter と HTML 本文で管理します。Git リモートは GitHub を想定しています（Vercel の Git 連携とも相性がよいです）。
メディア方針・未決バックログ・SEOメモは docs/メディア方針と実装メモ.md にまとめています（実装・運用時の参照用）。
ターミナルでこのフォルダに移動できる前提です。あなたが用意するのは 名前・メール・GitHub のトークン だけです（トークンは GitHub に一度も載せない でください）。
設定ファイルを作る（例にコピーして編集）
setup.secrets.env を開き、GIT_USER_NAME・GIT_USER_EMAIL・GH_TOKEN を埋めます。
gh auth login 済みなら、GH_TOKEN を空にしても push できます。初回の Git 設定・コミット・GitHub へ push を一括実行
（任意）Vercel をトークンだけで先に本番に出す
setup.secrets.env に VERCEL_TOKEN=...（Vercel → Account Settings → Tokens）を追加し:
push のたびに自動で本番更新したい場合（おすすめ）
Vercel で New Project → さきほどの GitHub リポジトリを Import（Root Directory は空のまま）。これで 2回目以降は git push だけでデプロイされます。
注意: setup.secrets.env は .gitignore 済みです。絶対にコミット・共有しないでください。 漏れたらトークンはすぐ無効化し、作り直してください。
microCMS は使わず、ファイルベースのみで公開します。
記事作成/記事化入力/ に元PDFを置きます。
チャットで「このPDFを記事化開始」と指示するか、nogyo-media で次を実行します。
実行すると次が作られます。
記事/元資料/記事と元資料/<ファイル名>/<ファイル名>_解説記事.html（雛形）<ファイル名>_作業メモ.md記事/元資料/記事と元資料/<ファイル名>/<ファイル名>_解説記事.html を完成させ、内容を確認します。
補足:
タイトル / 日付 / タグ / 読了目安 / 目次 / 共有操作 はサイト側で共通表示されます。<article> 内に本文を記述し、<h1> や先頭 <header> は原則不要です（重複表示を避けるため）。data:image / Base64画像 / SVGの data URI はそのまま公開しません。Google が読む HTML を極端に肥大化させるため、公開時には外部画像へ変換・軽量化します。例:
このコマンドで次を作成/更新します。
content/source-html/<slug>.htmlcontent/articles/<slug>.md（sourceHtmlFile 参照型）補足:
stage-article-for-web.sh は、HTML 内の data:image やローカル画像を public/article-images/<slug>/ に書き出し、HTML の src を公開用パスへ差し替えます。url(data:...) は変換対象外のため、含まれている場合はエラーで停止します。prepare-article-assets.py）。AVIF は環境によってデコードされず真っ白になることがあるため、public/article-images/**/*.avif と source-html 内の .avif 参照は npm run build 前の検証で失敗します。scripts/render-pdf-page-to-png.py（要 pymupdf）があります。公開は コミット と push の2段階に分かれています。article:publish はコミットまでで止まり、push しません。
publish-article.sh は content/articles/<slug>.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 は「投げて終わり」にしません。次の2つを push 直後に必ず済ませます。
npm run build が通っても本番に出たとは限りません。クエリを付けないプレーンな本番URLで、記事・図版・sitemap 掲載を確認します（?cb= などを付けるとキャッシュやルーティングが変わり「未反映」と誤判定します）。デプロイが数時間生成されないことが実際にあります。運営/公開キュー.tsv の該当行を更新する。 状態を 承認待ち → 公開済 にし、公開コミット 列にコミットハッシュを入れます。2 を飛ばすと、push は済んでいるのに台帳では「承認待ち」のままという行が溜まり、次に誰かが見たとき「まだ公開されていない記事」に見えます。2026-08-25 の棚卸しでは、この形のずれが3件見つかりました（うち1件は、コミットされないまま作業ツリーに4日間残っていた変更）。台帳はコミット直後ではなく push 直後に更新してください。コミットしただけの段階では、まだ公開されていないためです。
トップ・新着・カテゴリ・タグのハブページと、全公開記事を タイトル / URL / 公開日 の3列で出力します（ハブページの公開日列は空）。
| 項目 | 内容 |
|---|---|
| ファイル | public/articles-index.csv |
| 本番URL | https://agri-ja.net/articles-index.csv |
| 手動更新 | npm run articles:csv |
自動更新のタイミング
npm run article:publish … 記事 push 時に CSV も同じコミットへ含めるnpm run build … Vercel デプロイ前にも再生成（push 忘れがあっても本番 CSV は最新化）記事の元データは content/articles/*.md の frontmatter（title / slug / publishedAt）です。記事 URL は /articles/<slug> 形式です。
ブラウザで http://localhost:3000 を開きます。
本番ビルド:
.）で問題ありません。親フォルダに複数プロジェクトがあるモノレポのときだけ nogyo-media などサブフォルダを指定します。環境変数は現状のファイルベース記事のみでは不要です。ドメインやプレビュー URL は Vercel のプロジェクト設定から追加できます。
| タイミング | あなたがすること | 自動で行われること |
|---|---|---|
| 最初の1回 | 上記「はじめての公開まで」どおり setup.secrets.env を用意し、npm run setup:first-push。自動デプロイ用に Vercel でリポジトリを Import（または npm run setup:vercel で CLI デプロイ）。 | setup:first-push がコミットと GitHub への反映まで実行。 |
| 2回目以降 | 記事やコードを直して git push するだけ。 | Vercel が自動でビルド・本番反映（プルリクならプレビュー URL も自動）。GitHub Actions（.github/workflows/ci.yml）が npm run lint と npm run build を実行し、失敗したら赤く表示される。 |
| 依存ライブラリ | 特に何もしなくてよい（任意で Dependabot の PR をレビューしてマージ）。 | Dependabot（.github/dependabot.yml）が週1で更新案の PR を出す。 |
GitHub 上のリポジトリの Actions タブで、ワークフロー「CI」の成否を確認できます。Vercel のダッシュボードで各デプロイのログも見られます。
現在の標準運用では microCMS を使いません。
content/articles と content/source-html のファイルベース運用で公開します。
microCMS を有効にする場合も、各記事の tags に読者タグを1〜3個含めないとビルドに失敗します。
https://agri-ja.net/mcp で、記事と公開データを MCP（Model Context Protocol） のツールとして提供しています。実体は app/mcp/route.ts の1ファイルだけです。
search_articles / get_article / rice_advance_payment / find_subsidycontent/）。記事を publish すればMCP側も自動で最新になります。/mcp は実行時に content/ を読む唯一のルートなので、next.config.ts の outputFileTracingIncludes から外さないでください（外すと本番で ENOENT）。利用のしかた（案内するとき）: Claude / ChatGPT / Cursor の「カスタムコネクタ」に https://agri-ja.net/mcp を登録するだけです。所在は /llms.txt でも告知しています。
計測: MCP経由の利用は GA4 にも Search Console にも映りません。Vercel の Function Logs に出る [mcp] <method> <status> <ms> が唯一の計測点です。
net.agri-ja/agri-ja として登録済み（2026-08-07・status active）。名前空間は GitHub ではなく agri-ja.net のドメイン認証（HTTP方式） で取っています。
public/mcp-registry-auth → next.config.ts の rewrites で /.well-known/mcp-registry-auth として配信（Vercel は public/ 配下のドットディレクトリを配信しないため、public/.well-known/ に直接置くと本番で404になります）~/.config/mcp-registry/agri-ja-key.pem と agri-ja-privkey.hex（リポジトリ外。コミットしない）~/.local/bin/mcp-publisherツールを追加・変更したら server.json の version を上げて再公開します:
動作確認（ローカル）:
app/ — App Router のページ・レイアウトcomponents/ — ヘッダー・ヒーロー・カード・サイドバーcontent/articles/ — 記事 Markdown（frontmatter ＋ HTML 本文）lib/articles.ts — 記事データ層lib/categories.ts / lib/tags.ts — カテゴリ・読者タグ・テーマタグ正規語彙（THEME_TAG_REGISTRY）記事の tags には 読者タグ（生産者向け / 小売向け / 流通向け / 消費者向け）を 必ず1〜3個 含めてください。テーマタグは docs/theme-tags.md の正規語彙から 0〜3個 付けます。未登録タグや読者タグ個数違反はビルド時にエラーになります。
新規記事のテーマタグ提案: python3 scripts/suggest-theme-tags.py <slug> <category>
プライベートプロジェクト用。コンテンツの著作権は各出典に従ってください。