naramania

奈良県建築・入札情報収集・分析アプリ

概要

naramaniaは、奈良県内22自治体の入札公告・落札結果を自動収集・分析するWebアプリケーションです。

• 入札情報収集: 22自治体の入札公告・落札結果を自動スクレイピング
• AIインテリジェンス抽出: Google AIで案件内容を解析・分類
• ダッシュボード: 全案件数、新着更新、AI抽出/除外状況の可視化
• 入札チャット: 案件名や「今週の開札物件は？」のような自然文質問に回答
• 落札実績ランキング: 業者別受注ランキング
• レーダーチャート: 業者別得意分野分析

技術スタック

• Frontend: Next.js 16 + TypeScript + React 19
• Styling: Tailwind CSS + Framer Motion
• Scraping: Playwright + axios + cheerio
• AI: Google Generative AI (Gemini)
• AI Chat: Gemini API + Google Search grounding
• Visualization: Recharts
• Fonts: Shippori Mincho (Google Fonts)

プロジェクト構造

naramania/
├── src/
│   ├── app/              # Next.jsページとAPIルート
│   ├── components/        # Reactコンポーネント
│   ├── scrapers/         # 入札情報スクレイパー（22自治体対応）
│   ├── services/         # 外部サービス連携（ニュース、AI）
│   └── types/           # TypeScript型定義
├── scripts/             # 一時スクリプト・デバッグファイル
├── public/             # 静的リソース
└── scraper_result.json  # スクレイピング結果データ

対応自治体（25自治体）

自治体	スクレイパー
奈良県	nara_pref.ts（self-hosted runner 必須）
奈良市	nara_city.ts
橿原市	kashihara_city.ts
生駒市	ikoma_city.ts
大和高田市	yamato_takada_city.ts
大和郡山市	yamatokoriyama_city.ts
葛城市	katsuragi_city.ts
五條市	gojo_city.ts
御所市	gose_city.ts
天理市	tenri_city.ts
桜井市	sakurai_city.ts
宇陀市	uda_city.ts
田原本町	tawaramoto_town.ts
広陵町	koryo_town.ts
香芝市	kashiba_city.ts
川西町	kawanishi_city.ts
三宅町	miyake_city.ts
山添村	yamazohiragawa_city.ts（YamazomuraScraper）
平群町	yamazohiragawa_city.ts（HiragawaScraper）
安堵町	ando_city.ts
高取町	takatori_ikaruga.ts（TakatoriTownScraper）
斑鳩町	takatori_ikaruga.ts（IkarugaTownScraper）
三郷町	sango_town.ts
王寺町	oji_town.ts
大淀町	oyodo_town.ts

年度が替わってもページを追従できるよう、年度依存のURL・日付は src/scrapers/common/fiscal_year.ts のヘルパーで動的に解決します。

セットアップ

環境変数の設定

.env.localファイルを作成し、以下の環境変数を設定します：

GOOGLE_GENERATIVE_AI_API_KEY=your_api_key_here
GOOGLE_GENERATIVE_AI_CHAT_MODEL=gemini-3.1-flash-lite
NODE_OPTIONS=--no-deprecation

Vercel では Project Settings > Environment Variables に同じ値を設定してください。

依存パッケージのインストール

npm install

開発サーバーの起動

npm run dev

ブラウザで http://localhost:3000 にアクセスします。

スクレイパーの実行

すべての自治体の入札情報を収集する場合：

# PowerShellの場合
powershell -ExecutionPolicy Bypass -Command "cd naramania; npx tsx src/scrapers/index.ts"

# Bash/Command Promptの場合
npx tsx src/scrapers/index.ts

実行時間: 約7〜8分

データ管理

スクレイピング結果

• ファイル: scraper_result.json
• 形式: JSON配列
• 収集方針: 今年度（4月1日以降）の建築・建物系案件を中心に収集。 過年度分の網羅は行わない（前年度開始日より古い公告は自動除外）。

重複除外

スクレイパーは以下のロジックで重複を除外します：

1. 落札ステータス優先: Mapベースで管理
2. マージ処理: 新しい情報で既存データを更新
3. 日付降順: 公告日でソート

収集元の考え方（入札公告と開札結果の両輪）

各自治体について、入札公告（入札情報） と 開札結果（入札結果） の両方を必ず見る。 どちらか片方だけを見ていると、次のどちらかが起こる。

• 公告を見ていない → 応札できるうちに気づけない（結果が出てから知っても遅い）
• 結果を見ていない → 誰がいくらで取ったかが分からず、相場観も競合の動きも追えない

年度替わりやページ追加でURLが変わっても追従できるよう、 個別ページのIDをハードコードせず、一覧・カテゴリ・indexページから 配下のページを都度解決する方針とする。

収集元の一覧は src/lib/municipality_sources.ts（サイト内の「収集元サイト」ページ）に 実際にスクレイパーが見ているURLを揃えてある。スクレイパーの定数を変えたら必ず両方直す。

片肺運転（公告だけ／結果だけ）の検知は自動化してある。

• config/municipality_source_coverage.json の minAnnouncements / minResults
• npm run validate:quality … 保存済みデータに対して警告
• npm run audit:live-sources … 公開サイトへ実アクセスして自治体ごとに 公告N件 / 結果N件 を出力し、片側0件なら警告
• npm run report:coverage … 上記の結果を自治体ごとの表にして出力 （GitHub Actions 上では実行結果画面の Summary に表示される）

収集元の検証（PC不要）

スクレイパーを直したとき、実サイトに対して効いているかを確認する手順。

GitHub の Actions → Verify Source Coverage → Run workflow で ブランチを選んで実行すると、実サイトへアクセスして自治体ごとの 公告N件 / 結果N件 が実行結果画面に表で出る。ブラウザだけで完結する。

このワークフローは permissions: contents: read で commit も push もしないため、 ブランチ上（PRレビュー中）で実行しても main に影響しない。

対して daily_scrape と live_source_audit は結果を main に commit & push する。 こちらは main 以外での実行時に commit/push をスキップするガードを入れてある （ガードが無かった頃は、ブランチ上で手動実行するとそのブランチの中身が main へ push されてしまう状態だった）。

なお workflow_dispatch はワークフローファイルが default ブランチ(main)に 存在しないと実行ボタンが出ない（GitHubの仕様）。新しい検証ワークフローを 追加した直後は、先にそれを main へ入れてから対象ブランチを選んで実行する。

データ品質フィルタ

建築・建物系ではない一般業務や古い案件を除外するため、共通フィルタを使用しています。

• 設定ファイル: config/data_filters.json
• 除外例: 広報、印刷、給食、警備、計画策定、道路・水道などのインフラ案件、外壁・防水・空調・設備単体の工事
• 保持条件: 建物文脈のキーワードと、工事・設計・改修などの作業キーワードを両方含む案件
• 注意: 除外判定はタイトルベース。AI生成の要約・タグは除外判定に使わない（付随的な語で建築案件が誤除外されるのを防ぐため）

既存データへフィルタを再適用する場合：

npx tsx scripts/reapply_filter.ts

落札者情報

• 奈良市: テーブルから抽出
• 橿原市 / 天理市 / 広陵町: PDF解析（pdfjs-dist）
• EPI（入札情報公開サービス）利用自治体: 結果一覧テーブルから抽出 （生駒市・香芝市・大和高田市・桜井市・葛城市・五條市・宇陀市・三郷町）
• 奈良県: 個別詳細ページアクセスが必要（未実装）

EPI 系自治体の巡回は src/scrapers/common/epi_cloud.ts に共通化してある。 「発注情報の検索」（公告）と「入札・契約結果情報」（結果）の両メニューを、 業務区分（工事・コンサル）× 対象年度ぶん巡回する。

APIエンドポイント

GET /api/scrape

スクレイピング結果を取得します。

POST /api/scrape

スクレイピングを実行します（現在は既存データを返すのみ）。

GET /api/news

建設関連ニュースを取得します（15分キャッシュ）。

POST /api/analyze

AIによる案件解析を実行します。

POST /api/chat

入札チャットに質問を送ります。サイト内データを優先し、必要な場合は Gemini の Google Search grounding を使って Web 補足を返します。

ビルド

npm run build

デプロイ

Vercelへのデプロイ

npm run build
npm start

または Vercel Platform から直接デプロイします。

開発ガイド

コンポーネントの追加

新しいコンポーネントは src/components/ に追加します。

スクレイパーの追加

新しい自治体のスクレイパーは以下の手順で追加します：

1. src/scrapers/[municipality]_city.ts を作成
2. Scraper インターフェースを実装
3. src/scrapers/index.ts にインポートして登録

スタイリング

Tailwind CSSを使用しています。クラス命名規則に従ってください。

ライセンス

MIT

貢献

プルリクエストを歓迎します。

コンタクト

問題やご要望は GitHub Issues までご連絡ください。