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日以降）の建築・建物系案件を中心に収集。
過年度分の網羅は行わない（前年度開始日より古い公告は自動除外）。
重複除外
スクレイパーは以下のロジックで重複を除外します：
- 落札ステータス優先: Mapベースで管理
- マージ処理: 新しい情報で既存データを更新
- 日付降順: 公告日でソート
収集元の考え方（入札公告と開札結果の両輪）
各自治体について、入札公告（入札情報） と 開札結果（入札結果） の両方を必ず見る。
どちらか片方だけを見ていると、次のどちらかが起こる。
- 公告を見ていない → 応札できるうちに気づけない（結果が出てから知っても遅い）
- 結果を見ていない → 誰がいくらで取ったかが分からず、相場観も競合の動きも追えない
年度替わりやページ追加でURLが変わっても追従できるよう、
個別ページのIDをハードコードせず、一覧・カテゴリ・indexページから
配下のページを都度解決する方針とする。
収集元の一覧は src/lib/municipality_sources.ts（サイト内の「収集元サイト」ページ）に
実際にスクレイパーが見ているURLを揃えてある。スクレイパーの定数を変えたら必ず両方直す。
片肺運転（公告だけ／結果だけ）の検知は自動化してある。
config/municipality_source_coverage.json の minAnnouncements / minResultsnpm 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/ に追加します。
スクレイパーの追加
新しい自治体のスクレイパーは以下の手順で追加します：
src/scrapers/[municipality]_city.ts を作成Scraper インターフェースを実装src/scrapers/index.ts にインポートして登録
スタイリング
Tailwind CSSを使用しています。クラス命名規則に従ってください。
ライセンス
MIT
貢献
プルリクエストを歓迎します。
コンタクト
問題やご要望は GitHub Issues までご連絡ください。
