╔══════════════════════════════════════════════════════════════════╗
║  BatchFinder — Creator to Facebook Page Matcher                  ║
║  v1.0.0  ·  Chrome extension (Manifest V3)  ·  FREE BETA         ║
╚══════════════════════════════════════════════════════════════════╝

INSTALL (takes about 30 seconds)
──────────────────────────────────────────────────────────────────────
1. Unzip this file somewhere permanent, e.g.  C:\Tools\BatchFinder
      ⚠ Do NOT run it from inside the .zip, and do not delete or move
        the folder afterwards — Chrome loads it from that exact path.

2. Open Chrome and go to:      chrome://extensions

3. Turn ON "Developer mode"  (toggle, top-right corner).

4. Click "Load unpacked"  (top-left) and select the folder you
   unzipped — the one that directly contains  manifest.json

5. Pin BatchFinder to the toolbar (puzzle-piece icon → pin).

   There is NO license key. The beta is free and has no limits.


BEFORE YOUR FIRST SCAN
──────────────────────────────────────────────────────────────────────
Log into  https://facebook.com  in this same browser.

Facebook only lets logged-in users search, and BatchFinder searches as
you, in your own browser. It never asks for your password — it simply
uses the session you already have. Without it, every scan comes back
empty and the panel will tell you to log in.


HOW TO USE
──────────────────────────────────────────────────────────────────────
1. Click the BatchFinder icon → the side panel opens.

2. FIND tab — pick a platform, then paste your creators:
       @username           one per line
       a full profile URL  (a URL always sets its own platform, so you
                            can mix Instagram, YouTube and TikTok in
                            one batch)

3. Press "Find Facebook Pages" and leave it alone. BatchFinder opens
   background tabs to do the searching; they close themselves.

4. Read the results:
       94%  Very likely match     — their Page
       61%  Likely match          — probably theirs, confirm it
       34%  Unlikely              — ignore

       ⚠ "Posting their content"  — this Page carries the creator's
         videos but matches almost none of their identity. Someone is
         re-uploading them. The percentage shown is how much of their
         content it carries, not how likely it is to be theirs.

   "Why this score" opens the full breakdown behind any match.

5. "Export CSV" saves every ranked match for the whole batch.


THE OTHER TABS
──────────────────────────────────────────────────────────────────────
DISCOVER   Give it one creator; it lists the accounts each platform
           already recommends alongside them. Anything you have scanned
           before is tagged with when, and left unticked — so a repeat
           sweep only costs you the new names.

SETTINGS   Search depth, minimum confidence, and three things worth
           knowing about:

             Deep face recognition — compares faces, not just pictures,
               so the same person matches even in a different photo.
               The model is already included; nothing to install.

             Search their video titles too — this is what finds Pages
               re-uploading a creator's content. Leave it on.

             Skip creators already scanned — uses your history to keep
               repeat batches short.

           Rate matches with 👍 / 👎 and BatchFinder adjusts how much
           each signal counts for your niche. It needs 8 ratings before
           it changes anything.


GOOD TO KNOW
──────────────────────────────────────────────────────────────────────
· Works in Chrome, Edge, Brave and Arc. Not Firefox or Safari.

· There is no server. No account, no license check, no telemetry —
  your lists, results and history never leave your browser.

· BatchFinder reads only public profile information, the same fields
  any visitor sees. It does not touch private accounts.

· A confidence score is a lead to confirm, not proof of identity.
  That is why every score comes with its reasoning.

· A scan is slower than a web search because it actually opens and
  reads each candidate Page. Roughly 30-60 seconds per creator.


IF SOMETHING BREAKS
──────────────────────────────────────────────────────────────────────
Facebook changes its search layout fairly often, which can break the
part that reads the results. If scans suddenly return nothing for
everyone, that is usually why — message us and we will push an update.

WhatsApp support:  https://batchgpt.store/batchfinder.html

This is a beta. Telling us what went wrong is the whole point of it.
