MLIT Property Prices MCP

Kensho — X懸賞自動応募システム

X（Twitter）の懸賞応募（いいね・RT・フォロー）を完全自動化。 5アカウント で稼働、月1〜3万円の副収入を目指します。

クイックスタート

cd /mnt/d/Project2/kensho

# セットアップ
python -m venv ~/kensho-venv
source ~/kensho-venv/bin/activate
pip install -e ".[dev]"
pre-commit install

# テスト実行
make test

# 収集のみ
python kensho/kensho_collect.py --max-items 10 --pages 1

# 応募（1垢、最大N件）
python kensho/kensho_apply_single.py atushi16 5

# 常駐デーモン
python kensho/daemon.py

ディレクトリ構成

/mnt/d/Project2/kensho/
├── kensho/                       # 全Pythonコード
│   ├── orchestrator.py           # オーケストレーター（15分おき）
│   ├── kensho_collect.py         # CLIラッパー
│   ├── kensho_apply_single.py    # 単一アカウント応募
│   ├── daemon.py                 # 常駐デーモン
│   ├── application/
│   │   ├── applier.py            # 応募ロジック（Like/RT/Follow）
│   │   ├── browser.py            # invisible_playwright Firefox制御
│   │   ├── rate_limiter.py       # レート制限・動作時間管理
│   │   ├── reply_generator.py    # リプライ生成（未使用）
│   │   ├── session_manager.py    # Xセッション管理
│   │   └── state.py              # 応募状態管理
│   ├── core/
│   │   ├── config.py             # 設定読み込み（YAML + Pydantic v2モデル）
│   │   ├── logger.py             # ログ出力（loguru）
│   │   ├── cleanup.py            # ゾンビプロセス掃除（psutil）
│   │   ├── crash_guard.py        # クラッシュガード
│   │   ├── encoding.py           # UTF-8ガード
│   │   ├── lock.py               # PIDロック
│   │   └── notifier.py           # 通知
│   ├── scraping/                 # 収集エンジン
│   │   ├── collector.py
│   │   └── sources/              # 収集元サイト別パーサー
│   ├── utils/
│   │   ├── backup.py             # 自動バックアップ/復旧
│   │   ├── keyring.py            # Xセッション管理
│   │   ├── network.py            # ネットワークユーティリティ
│   │   ├── process.py            # サブプロセス実行
│   │   └── safety.py             # IP分離チェック
│   ├── keepalive/                # ネットワーク監視
│   └── tools/                    # 診断・保守ツール
├── scripts/                      # シェルスクリプト（cron, health check）+ 収益系watchスクリプト
│                                 #   （seo_rank_watch.py: dev.to/Apify順位監視、apify_store_check.py: ストア監査）
├── tests/                        # pytest（104 passed, 4 skipped）
├── data/                         # JSONデータ類
├── logs/                         # ログ（日付別）
├── config.yaml                   # 全体設定
├── pyproject.toml                # プロジェクト管理
├── .pre-commit-config.yaml       # pre-commit設定
├── Makefile                      # タスクランナー
├── .github/workflows/ci.yml      # GitHub Actions CI
└── README.md

開発用コマンド

make test       # テスト実行（104 passed）
make lint      # Ruff Lint
make format    # Ruff Format
make setup     # 依存関係 + pre-commit インストール
make coverage  # カバレッジレポート

情報検索

# Xのツイート内容を読む（認証不要）
web_search xfetch "https://x.com/user/status/123456789"

# Xの投稿を検索
web_search xsearch "invisible_playwright reCAPTCHA"

# 5chのスレッドを検索
web_search fch "懸賞 自動応募"

運用ルール

• 稼働時間: 09:00〜22:00
• 1セッション最大: 5件（config.yamlで調整可）
• 日次上限: フォロー50 / RT 15 / いいね80 / 垢
• アクション間隔: 15〜50秒（人間らしいランダム）
• 応募方式: フォロー/RT/いいねのみ（リプライ廃止）
• BOT対策: invisible_playwright + C++レベル指紋偽装 + アカウント別UA

5アカウント構成

アカウント	役割	バッチ数	日次最大
@atushi16	収集＋応募	3回	45件
@kudou_aoshi	応募のみ	5回	50件
@chugakujuken	応募のみ	5回	50件
@zin20120731	応募のみ	5回	50件
@TankanNotes	応募のみ	5回	50件

技術スタック

要素	採用技術
ブラウザ自動化	invisible_playwright (Firefox 150.0.1, C++レベル指紋偽装)
BOT検出回避	reCAPTCHA v3 score 0.9, CreepJS零警告
設定管理	Pydantic v2 型安全モデル (KenshoConfig)
ログ	loguru (自動ローテーション)
Lint/Format	Ruff (pre-commit統合)
型チェック	mypy (strict設定)
CI/CD	GitHub Actions (Lint + 72テスト)
プロキシ	SOCKS5（アカウント別IP対応）
実行環境	WSL2 (Ubuntu) on Windows 11

データ商品・外部API（収益化資産）

Apify Store — 86 Actors (PPE課金・無料枠あり)

• マーケットプレイス: atushi1841のアクター一覧
• 課金モデル: PPE (Pay Per Event) — 実行ごと課金、無料枠あり
• 主力カテゴリ: メルカリ / Yahooオークション / 楽天 / SUUMO / 価格.com / 1688 / テレ東 / 他
• 全アクター: seoTitle/seoDescription 完備 / 最小権限 / カテゴリ設定済み
• レビュー獲得・外部掲載で可視性向上中（dev.to / GitHub / MCPレジストリ）

Actor統合方針（2026-10-09確定）

同一対象の分割出品により人気シグナルが分散していたため、以下の方針で統合完了:

カテゴリ	主力Actor（推奨）	統合済み（非推奨）	削減
watch	japan-watch-market-scraper	-cn, -kr, jackroad-used-watch	4→1
luxury	japan-luxury-brand-market-scraper	-cn, -kr	3→1
instrument	japan-used-instrument-market-scraper	-cn, -kr, digimart-japan-used	4→1
offmall	japan-offmall-market-scraper	-cn, -kr	3→1
suumo	suumo-japan-real-estate-scraper	—	1（既存）
kakaku	japan-kakaku-price-search	—	1（既存）

合計: 16 actors → 6 actors（10件統合）

関連actorはメインactorの解説セクションで言及し、間接的リンクを経由させる方針。

Gumroad — デジタル商品販売

• 商品ページ: agyhq — アニメフィギュア価格データセット
• 週次更新データを自動配信（GitHub Releases連動）

GitHub Releases — 週次データセット公開

• リリースページ: atushi1841/kensho/releases
• 毎週月曜 09:00 JST 自動公開（GitHub Actions）
• ファイル: anime_figure_prices_weekly/YYYY-Www.csv.gz (≈900 KB)
• スキーマ: figure_id / name / series / character / manufacturer / release_date / scale / msrp_jpy / lowest_price_jpy / highest_price_jpy / in_stock_count / offers(JSON) / fetched_at / confidence / sources_merged

MCP レジストリ — 10 servers 公開中

Kensho の MCP サーバー群を AI クライアント（Claude / Cursor / VS Code 等）から直接呼び出せるよう、主要レジストリに登録済み。

レジストリ	サーバー数	状態
MCP 公式レジストリ	10	✅ active（io.github.atushi1841/*、検索）
Smithery	6	✅ description / icon / repositoryUrl 充実
mcp.so	6	📝 YAML 設定済（手動提出待ち）

公開サーバー（共に read-only・ローカルデータ・APIキー不要）:

• kensho-sweep-mcp — 懸賞campaignデータ 1133件
• kensho-kaku — ken-kaku.com 懸賞データ
• kensho-kclub — kenshou.club 懸賞データ
• kensho-kema — ke-ma.net 懸賞データ
• japan-anime-figure-mcp — アニメフィギュア価格比較
• tcg-price-japan — TCG（ポケモン）中古価格
• japan-fuel-price-mcp — 国内燃料価格（都道府県別）
• japan-minimum-wage-mcp — 最低賃金（47都道府県）
• japan-ec-mcp — 国内EC価格比較
• mlit-property-prices-mcp — 国土交通省 不動産取引価格（MCPBバンドル）

接続方法（mcp.so YAML 設定は mcp_so_configs/ 参照）:

{ "mcpServers": { "kensho-sweep-mcp": { "command": "python", "args": ["${__dirname}/main.py"] } } }

収益化経路: mcp.so 経由でアクターが見つかる → Apify Store（86 Actors, PPE課金）へ流入。

データセット仕様書

|- README_DATASET.md — 詳細スキーマ・ダウンロード方法・有償版(履歴データ)案内

---

関連リソース

• Hermes Agent profile: kensho-sweeps
• 設定ファイル: ~/.hermes/profiles/kensho-sweeps/config.yaml
• cronジョブ: 15分おき（active_hours内のみ）
• Obsidian vault: ../kensho-wiki/（プロジェクト外）