Hermes HK/Taiwan Research Workflow
Terminal-only workflow for finding official public source pages for restaurants, cafes, car wash/detailing, repair, laundry, fitness, education, pet grooming, phone repair, design studio, salon, clinic, and other service businesses. No emails are sent from this workflow.
Commands
npm run research:workflow -- --markets=hk,tw --segments=cafe,restaurant,car-wash,auto-detailing,appliance-repair,laundry,fitness,education,pet-grooming,phone-repair,design-studio,salon,clinic,home-service --limit=120 Add official source URLs to data/research-seed-urls.txt, one URL per line. npm run research:seed-audit -- --seed=data/research-seed-urls.txt --limit=25 --crawl-limit=5 HERMES_NO_BROWSER=1 PHASE=0 DRY_RUN=true npm run source:batch-preview -- --seed=data/research-ready-seed-urls.txt --limit=10 --crawl-limit=5 HERMES_NO_BROWSER=1 PHASE=0 DRY_RUN=true npm run source:batch-preview -- --seed=data/research-ready-seed-urls.txt --limit=10 --crawl-limit=5 --json npm run agent:background:status
Source Quality Checks
- URL must be an official business website, contact page, menu/services page, or official social profile.
- Email must be visible on the public source page or exposed through a mailto link.
- Region must clearly be Taiwan or Hong Kong from the domain, address, city, or page copy.
- Prefer source pages that also expose Instagram, Facebook, LINE, specific same-business Google Maps place/search/directions URLs, logo, hero image, menu, or service URLs.
- Google Maps evidence must be a public Maps place/search/directions target matching the business name, address, city, or official short Maps link; reject generic Google search pages, coordinate-only viewports, embeds, and unrelated places.
- Social links must be official profiles for the same business; reject share URLs, post/reel/story URLs, login pages, groups, and generic platform chrome.
- Photos must be usable business/media candidates from official pages or same-business public sources; reject logos/icons, QR codes, placeholders, tracking pixels, flags, tiny thumbnails, and share-card images.
- Ready research needs identity, public email, local proof, official channel, menu/services, and at least two usable public photo candidates.
- Reject directory-only rows unless they link to an official business page that Hermes can fetch and verify.
- No outreach is sent from this workflow; generated demos remain preview-only until send gates are intentionally opened.
Background Safety
- Use terminal commands only; do not open or control the visible Google, YouTube, ChatGPT, or Gmail browser tab.
- Run background work with HERMES_NO_BROWSER=1 and HERMES_BROWSER_POLICY=forbid-visible-browser.
- Keep PHASE=0 and DRY_RUN=true while researching and generating previews.
- Store seed URLs in local data files; never store normal account passwords or app passwords in source-controlled files.
- Review extracted socials and media as public candidates before treating them as approved website content.
Search Queue
| Market | City | Segment | Intent | Search | Evidence | Socials |
|---|---|---|---|---|---|---|
| Hong Kong | Central | Cafe | official-website | Central Hong Kong cafe official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Central | Cafe | contact-email | Central Hong Kong cafe contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Central | Cafe | social-proof | Central Hong Kong cafe Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps | official social URL, Google Maps URL, same business name across sources, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Central | Cafe | menu-services | Central Hong Kong cafe menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Central | Restaurant | official-website | Central Hong Kong restaurant official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Central | Restaurant | contact-email | Central Hong Kong restaurant contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Central | Restaurant | social-proof | Central Hong Kong restaurant Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps LINE | official social URL, Google Maps URL, same business name across sources, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Central | Restaurant | menu-services | Central Hong Kong restaurant menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Wan Chai | Cafe | official-website | Wan Chai Hong Kong cafe official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Wan Chai | Cafe | contact-email | Wan Chai Hong Kong cafe contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Wan Chai | Cafe | social-proof | Wan Chai Hong Kong cafe Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps | official social URL, Google Maps URL, same business name across sources, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Wan Chai | Cafe | menu-services | Wan Chai Hong Kong cafe menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Wan Chai | Restaurant | official-website | Wan Chai Hong Kong restaurant official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Wan Chai | Restaurant | contact-email | Wan Chai Hong Kong restaurant contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Wan Chai | Restaurant | social-proof | Wan Chai Hong Kong restaurant Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps LINE | official social URL, Google Maps URL, same business name across sources, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Wan Chai | Restaurant | menu-services | Wan Chai Hong Kong restaurant menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Causeway Bay | Cafe | official-website | Causeway Bay Hong Kong cafe official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Causeway Bay | Cafe | contact-email | Causeway Bay Hong Kong cafe contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Causeway Bay | Cafe | social-proof | Causeway Bay Hong Kong cafe Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps | official social URL, Google Maps URL, same business name across sources, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Causeway Bay | Cafe | menu-services | Causeway Bay Hong Kong cafe menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Causeway Bay | Restaurant | official-website | Causeway Bay Hong Kong restaurant official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Causeway Bay | Restaurant | contact-email | Causeway Bay Hong Kong restaurant contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Causeway Bay | Restaurant | social-proof | Causeway Bay Hong Kong restaurant Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps LINE | official social URL, Google Maps URL, same business name across sources, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Causeway Bay | Restaurant | menu-services | Causeway Bay Hong Kong restaurant menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Tsim Sha Tsui | Cafe | official-website | Tsim Sha Tsui Hong Kong cafe official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Tsim Sha Tsui | Cafe | contact-email | Tsim Sha Tsui Hong Kong cafe contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Tsim Sha Tsui | Cafe | social-proof | Tsim Sha Tsui Hong Kong cafe Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps | official social URL, Google Maps URL, same business name across sources, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Tsim Sha Tsui | Cafe | menu-services | Tsim Sha Tsui Hong Kong cafe menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Tsim Sha Tsui | Restaurant | official-website | Tsim Sha Tsui Hong Kong restaurant official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Tsim Sha Tsui | Restaurant | contact-email | Tsim Sha Tsui Hong Kong restaurant contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Tsim Sha Tsui | Restaurant | social-proof | Tsim Sha Tsui Hong Kong restaurant Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps LINE | official social URL, Google Maps URL, same business name across sources, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Tsim Sha Tsui | Restaurant | menu-services | Tsim Sha Tsui Hong Kong restaurant menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Mong Kok | Cafe | official-website | Mong Kok Hong Kong cafe official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Mong Kok | Cafe | contact-email | Mong Kok Hong Kong cafe contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Mong Kok | Cafe | social-proof | Mong Kok Hong Kong cafe Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps | official social URL, Google Maps URL, same business name across sources, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Mong Kok | Cafe | menu-services | Mong Kok Hong Kong cafe menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Mong Kok | Restaurant | official-website | Mong Kok Hong Kong restaurant official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Mong Kok | Restaurant | contact-email | Mong Kok Hong Kong restaurant contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Mong Kok | Restaurant | social-proof | Mong Kok Hong Kong restaurant Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps LINE | official social URL, Google Maps URL, same business name across sources, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Mong Kok | Restaurant | menu-services | Mong Kok Hong Kong restaurant menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Kwun Tong | Cafe | official-website | Kwun Tong Hong Kong cafe official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Kwun Tong | Cafe | contact-email | Kwun Tong Hong Kong cafe contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Kwun Tong | Cafe | social-proof | Kwun Tong Hong Kong cafe Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps | official social URL, Google Maps URL, same business name across sources, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Kwun Tong | Cafe | menu-services | Kwun Tong Hong Kong cafe menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Kwun Tong | Restaurant | official-website | Kwun Tong Hong Kong restaurant official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Kwun Tong | Restaurant | contact-email | Kwun Tong Hong Kong restaurant contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Kwun Tong | Restaurant | social-proof | Kwun Tong Hong Kong restaurant Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps LINE | official social URL, Google Maps URL, same business name across sources, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Kwun Tong | Restaurant | menu-services | Kwun Tong Hong Kong restaurant menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Sha Tin | Cafe | official-website | Sha Tin Hong Kong cafe official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Sha Tin | Cafe | contact-email | Sha Tin Hong Kong cafe contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Sha Tin | Cafe | social-proof | Sha Tin Hong Kong cafe Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps | official social URL, Google Maps URL, same business name across sources, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Sha Tin | Cafe | menu-services | Sha Tin Hong Kong cafe menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Sha Tin | Restaurant | official-website | Sha Tin Hong Kong restaurant official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Sha Tin | Restaurant | contact-email | Sha Tin Hong Kong restaurant contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Sha Tin | Restaurant | social-proof | Sha Tin Hong Kong restaurant Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps LINE | official social URL, Google Maps URL, same business name across sources, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Sha Tin | Restaurant | menu-services | Sha Tin Hong Kong restaurant menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Hong Kong | Cafe | official-website | Hong Kong cafe official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Hong Kong | Cafe | contact-email | Hong Kong cafe contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Hong Kong | Cafe | social-proof | Hong Kong cafe Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps | official social URL, Google Maps URL, same business name across sources, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Hong Kong | Cafe | menu-services | Hong Kong cafe menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, hours, address, email, Instagram | Instagram, Facebook, Google Maps |
| Hong Kong | Hong Kong | Restaurant | official-website | Hong Kong restaurant official website contact email site:.hk site:.com.hk Hong Kong 香港 | official website URL, contact page, visible public business email, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Hong Kong | Restaurant | contact-email | Hong Kong restaurant contact us mailto email site:.hk site:.com.hk Hong Kong 香港 | mailto link or visible business email, business name, Taiwan/Hong Kong location, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Hong Kong | Restaurant | social-proof | Hong Kong restaurant Instagram Facebook Google Maps site:.hk site:.com.hk Hong Kong 香港 Instagram Facebook Google Maps LINE | official social URL, Google Maps URL, same business name across sources, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |
| Hong Kong | Hong Kong | Restaurant | menu-services | Hong Kong restaurant menu services price list site:.hk site:.com.hk Hong Kong 香港 | menu/services URL, source-backed service or menu items, hours or address, menu, booking, hours, address, email | Instagram, Facebook, Google Maps, LINE |