BoPeng/ai-marketplace-monitor

AI Marketplace Monitor (AIMM)

概要 – AIMM は Python ベースのユーティリティで、Facebook Marketplace に自動ログインし、指定したアイテムを検索し、LLM を使用して各リスティングを評価します。その後、PushBullet、Telegram、メールなどのチャネルを介して、「お買い得; 予備バッテリー付きの手頃なカメラ」 のような短い AI 生成の評価を含む通知を送信します。

主要コンポーネント

• ブラウザ自動化 – Playwright を利用し、AIMM は実際のブラウザを操作して、Facebook の認証情報でログインし、CAPTCHA を処理し、リスティングをスクレイピングします。
• AI 評価 – タイトル、説明、価格、出品者情報を LLM（OpenAI、Anthropic、Gemini、DeepSeek、Ollama、または UnitySVC ゲートウェイ経由でアクセス可能な任意のモデル）に送信します。モデルは評価と短い理由を返します。
• 出品者の評判分析 – 出品者のアカウント年数、過去のリスティング、評価、購入者レビューを調べ、新規または不審なアカウントをフラグします。
• 会話による設定 – aimm configure は、AI キー、Facebook 認証情報、監視するアイテム、価格制限、地域、通知チャネルの設定を案内し、TOML 設定ファイルを生成します。
• Web UI – 軽量なローカル Web インターフェース（http://127.0.0.1:8467）で、TOML の編集、ライブログの表示、AI 評価付きの各リスティングの確認、モニターの制御（一時停止/再生）が可能です。
• 通知 – UnitySVC または直接統合（PushBullet、PushOver、Telegram、メールなど）を介して 100 以上のチャネルをサポート。即時アラートと日次ダイジェストをサポートします。
• どこでも展開 – pip でインストールして直接実行するか、公式 Docker イメージを使用します。コンテナには仮想ディスプレイが含まれているため、ヘッドレス NAS、TrueNAS、Unraid、Synology などで動作します。

典型的なワークフロー

1. パッケージをインストールします（pip install ai-marketplace-monitor && playwright install）。
2. Facebook のユーザー名/パスワードと AI キー（または UnitySVC キー）をエクスポートします。
3. aimm configure を実行します – 自然言語のプロンプトに回答して、監視する内容を定義します（例：「ヒューストンで 250 ドル以下の GoPro」）。
4. aimm（または docker run …）でモニターを起動します。
5. AIMM がログインし、設定した間隔で検索し、LLM で各新規リスティングを評価し、通知をプッシュします。

重要性 – Web 自動化、LLM ベースのセマンティックフィルタリング、マルチチャネルアラートを組み合わせて、ノイズの多いマーケットプレイスを焦点を絞ったディールファインダーに変え、控えめな家庭用ハードウェアで動作します。

法的注意 – README は、Facebook Marketplace の自動スクレイピングが Facebook の利用規約に違反する可能性があると警告しています。このツールは個人の趣味用途を目的としており、コンプライアンスの責任はユーザーにあります。

---

クイックスタートスニペット

pip install ai-marketplace-monitor
playwright install
export FACEBOOK_USERNAME='you@example.com'
export FACEBOOK_PASSWORD='secret'
export OPENAI_API_KEY='sk-…'   # または UNITYSVC_API_KEY
aimm configure   # AI 支援セットアップを実行
aimm              # モニタリングを開始