BoPeng/ai-marketplace-monitor

AI Marketplace Monitor (AIMM)

기능 – AIMM은 Python 기반 유틸리티로, Facebook Marketplace에 자동으로 로그인하여 지정한 항목을 검색하고 LLM을 사용하여 각 게시물을 평가합니다. 그런 다음 *"훌륭한 거래; 추가 배터리가 포함된 합리적인 가격의 카메라"*와 같은 짧은 AI 생성 평가와 함께 알림(PushBullet, Telegram, 이메일 등)을 보냅니다.

주요 구성 요소

• 브라우저 자동화 – Playwright로 구동되는 AIMM은 실제 브라우저를 구동하여 Facebook 자격 증명으로 로그인하고, CAPTCHA를 처리하며, 게시물을 스크랩합니다.
• AI 평가 – 제목, 설명, 가격 및 판매자 정보를 LLM(OpenAI, Anthropic, Gemini, DeepSeek, Ollama 또는 UnitySVC 게이트웨이를 통해 연결 가능한 모든 모델)에 보냅니다. 모델은 평점과 간단한 근거를 반환합니다.
• 판매자 평판 분석 – 판매자의 계정 연령, 과거 게시물, 평점 및 구매자 리뷰를 확인하여 새 계정이나 의심스러운 계정을 식별합니다.
• 대화형 구성 – aimm configure는 AI 키, Facebook 자격 증명, 관심 항목, 가격 한도, 지역 및 알림 채널 설정을 안내하고 TOML 구성 파일을 작성합니다.
• 웹 UI – 가벼운 로컬 웹 인터페이스(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으로 각 새 게시물을 평가하고, 알림을 보냅니다.

중요한 이유 – 웹 자동화, 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              # 모니터링 시작