couple_matters/tools/XIAOZHU_MINSU_README.md

Xiaozhu Minsu Scraper - Location Client Interface

Scraper pour https://minsu.xiaozhu.com/ (interface client, pas landlord).

Style: Airbnb-like, apparts de particuliers ✨

Critères configurés

• 📅 Dates: 24 déc 2025 → 22 jan 2026 (29 jours)
• 📍 Zone: Xujiahui District (徐汇区), près de Jiaotong University
• 💰 Budget: 3000-5000 RMB/mois (= ~2900-4833 RMB pour 29 jours)
• ✅ Must-have: Cuisine (厨房) + Frigo (冰箱)
• 🎁 Nice-to-have: Machine à laver (洗衣机), Métro (地铁)

Setup - Extraction cookies Firefox

Méthode 1 : Avec extension (RECOMMANDÉ - 30 sec)

1. Installe Cookie-Editor (extension Firefox)
2. Va sur https://minsu.xiaozhu.com/ dans Firefox
3. Login si nécessaire
4. Click icône Cookie-Editor → Export → Copy all as JSON
5. Edit firefox_cookie_converter.js :

   const cookiesJSON = [PASTE_YOUR_JSON_HERE];
   

6. Run:

   node firefox_cookie_converter.js
   

Méthode 2 : Manuel (2 min)

1. Firefox → https://minsu.xiaozhu.com/
2. F12 → Onglet Storage (Stockage)
3. Cookies → https://minsu.xiaozhu.com
4. Select all (Ctrl+A) → Right click → Copy
5. Edit firefox_cookie_converter.js :

   const cookiesDevTools = `
   [PASTE_YOUR_COOKIES_HERE]
   `;
   

6. Run:

   node firefox_cookie_converter.js
   

Output

✅ Génère xiaozhu_cookies.json (format Puppeteer)

Run le scraper

node xiaozhu_minsu_scraper.js

Ce qui se passe:

1. ✅ Charge tes cookies (si dispos)
2. 🔍 Essaie plusieurs URLs de recherche
3. 📝 Cherche input de recherche pour "上海 徐汇区"
4. 📊 Extrait toutes les annonces
5. 🎯 Filtre selon critères (budget, équipements)
6. ⭐ Score chaque appart (prix + équipements + localisation)
7. 💾 Génère 2 fichiers :
   • xiaozhu_minsu_results.json
   • xiaozhu_minsu_results.md
8. 📸 Screenshots : xiaozhu_minsu_page.png, xiaozhu_minsu_final.png

Scoring

Formule (plus haut = mieux) :

• Prix ≤ idéal (4000/mois): +bonus
• Prix > idéal: Petit malus
• Cuisine: +20 pts (required)
• Frigo: +15 pts (required)
• Machine à laver: +10 pts
• Métro: +15 pts
• Dans Xujiahui District: +20 pts
• Mention "交通大学": +10 pts

Output Markdown

Tableau format:

#	Title	Daily	Total	Kitchen	Fridge	Washer	Metro	Score	Link
1	温馨一居室...	¥120	¥3480	✓	✓	✓	✓	85.2	View

Troubleshooting

"No cookies found"

→ Run firefox_cookie_converter.js d'abord

Page structure différente

→ Check xiaozhu_minsu_page.html sauvegardé pour inspecter la structure → Les sélecteurs CSS peuvent nécessiter mise à jour ligne 140-180 du scraper

Aucun résultat

Possible causes:

1. Site nécessite login (cookies invalides/expirés)
2. URL de recherche incorrecte (le scraper teste plusieurs patterns)
3. Structure HTML a changé (inspecter screenshots)

Solutions:

1. Re-extract les cookies (méthode 1 ou 2)
2. Ouvre minsu.xiaozhu.com manuellement, note l'URL correcte de recherche Shanghai
3. Update les searchUrls dans le scraper ligne 77-82

Next Steps après résultats

Quand tu as les TOP résultats:

1. ✅ Ouvre les URLs dans Firefox
2. 📸 Check photos, reviews
3. 📝 Lit description complète
4. 📞 Contact propriétaires (questions en chinois ci-dessous)

Questions propriétaire (Copier-coller WeChat)

你好！我对你的房源很感兴趣。

入住日期：12月24日 - 1月22日（29天）
有几个问题想确认一下：

1. 这个价格是每天的价格吗？29天一共多少钱？
   (This price is per day? How much for 29 days total?)

2. 押金多少？
   (How much deposit?)

3. 包水电煤吗？
   (Utilities included?)

4. 有厨房和冰箱吗？
   (Has kitchen and fridge?)

5. 有洗衣机吗？
   (Has washing machine?)

6. 离交通大学地铁站多远？
   (How far from Jiaotong University metro?)

7. 可以签合同吗？
   (Can we sign a contract?)

8. 什么时候可以看房？
   (When can I view the apartment?)

谢谢！

Files générés

tools/
├── firefox_cookie_converter.js    # Convertisseur cookies
├── xiaozhu_minsu_scraper.js       # Scraper principal
├── xiaozhu_cookies.json           # Cookies convertis (auto-généré)
├── xiaozhu_minsu_results.json     # Résultats JSON (auto-généré)
├── xiaozhu_minsu_results.md       # Tableau lisible (auto-généré)
├── xiaozhu_minsu_page.png         # Screenshot page (auto-généré)
├── xiaozhu_minsu_final.png        # Screenshot final (auto-généré)
└── XIAOZHU_MINSU_README.md        # Ce fichier

---

Xiaozhu vs Ziroom:

• ✅ Xiaozhu: Airbnb-like, apparts persos, chaleureux, flexible
• ❌ Ziroom: Corporate, standardisé, contrats longs

T'as fait le bon choix 😎