A lightweight, bulletproof tool to bulk-scrape character links from Chub.ai and instantly import them into SillyTavern by simply copying and pasting. Built from the ground up to survive strict mobile browser security, and now fully universal—run it as a sleek mobile Bookmarklet or a native desktop Userscript!
- 📱 Universal Support: Works flawlessly via Bookmarklet on Android (Firefox, Chrome, Edge), iOS Safari and Windows OR natively via Tampermonkey/Violentmonkey on Desktop or Mobile Extension!
- 🔄 Auto-Updating: The mobile Injector Bookmarklet and Monkey-Script fetch the live upgrades directly from GitHub. You never have to manually update your mobile bookmark again.
- 🛡️ Flexbox Armor: The floating UI panel perfectly adapts to device rotations and virtual keyboards without clipping off-screen.
- 🕹️ Draggable UI: Press and drag the top header to move the panel anywhere on your screen. Expand (
➕) or collapse (➖) the panel to save screen space. - 🎯 Target Mode (Sniper): Click the
🎯button to manually snipe a single character card right from the feed without triggering page navigation. - ⚙️ Advanced Tag Filtering: Set specific "Should Include" (OR) and "Must Exclude" (AND) tags to dynamically filter out unwanted cards before they ever reach your list.
- 🧠 Smart Whitelisting & Dynamic Editing: Add specific creators to your "Approved" list. The scraper only grabs their links and automatically filters out duplicates. Easily remove them later using interactive
×UI tags. - 💾 Persistent Memory: The script remembers your scraped links even if you refresh the page or navigate to Page 2, 3, etc.
- ⚡ Advanced Exporting: Generate a clean text box of URLs to copy natively, download them directly as a
.txtfile, and utilize "Auto-clear" features to seamlessly manage consecutive scraping sessions.
You can install the scraper in two different ways depending on your device:
Because mobile browsers don't support traditional extensions easily, this tool runs as an "Injector Bookmarklet" (a tiny piece of JavaScript disguised as a bookmark that fetches the main code).
- Open the
bookmarklet.jsfile in this repository and copy the entire block of code. - Open your mobile browser and bookmark any random webpage.
- Edit the bookmark you just created:
- Name: Change it to something short, like "CCLS" or "Chub Link Scraper".
- URL / Address: Delete the website link and paste the code you copied in Step 1.
- Save it. You're done!
If you use a PC browser with an extension manager like Tampermonkey or Violentmonkey, installation takes one click.
- Click this link: Install scraper.user.js
- Your extension manager will pop up and ask if you want to install it. Click "Install" or "Confirm".
- The script will now run automatically whenever you visit Chub.ai!
If you installed the Bookmarklet, you need to launch it when you visit Chub.ai. Depending on your browser, use one of these methods:
📱 The "Address Bar" Method (Best for Android Chrome) On Android, tapping scripts from a bookmarks menu can sometimes be blocked. The most reliable way to launch it is using the "Omnibox Trick":
- Navigate to Chub.ai.
- Tap directly into the URL Address Bar.
- Type the name of your bookmark (e.g.,
CCLS). - Look at the autocomplete dropdown. You will see a suggestion with your bookmark icon.
- Tap the suggestion to instantly launch the panel!
🍎 The "Bookmarks Menu" Method (Best for iOS Safari & Android Edge)
- Navigate to Chub.ai.
- Open your Bookmarks Menu and simply tap on your created bookmark.
- Authorize the Creator(s): Once the panel is open on a creator's profile page, tap
+ Add Creator. - Scrape: Tap
+ Scrape Page. The script will harvest all valid character links on your screen. - Turn the Page: Use Chub's site navigation to go to Page 2, 3, etc. (If the panel disappears when the new page loads, just launch the bookmarklet again—it remembers your saved links as long as the tab hasn't been completely closed!)
- Expand the Hunt (Optional): Repeat steps 1-3 for any creators you like. As long as a creator is whitelisted, you can scrape their bots from the Trending Page, the Search, or anywhere else on Chub! You can also use Target Mode (
🎯) to grab single cards on the fly. - Export: When you are done hoarding, tap
Show Links. - Copy & Close: Tap the
Copybutton on the popup (it will light up green if successful). Afterward, you can shut down the script completely by pressing the red❌button, or pressBackto close the popup and keep scraping.
- Open SillyTavern (or your URL-import compatible client) and switch to the Character Management tab.
- Click on the External Import button (a cloud with a downward arrow).
- Paste your massive list of links into the bottom box and let ST download your new character army!
- Pro-Tip: Make sure "Import Card Tags" in the ST "User Settings" tab is NOT set to "Ask". If it is, you will have to manually confirm the tags for each new import, slowing the whole process down majorly!
I am actively working to expand the capabilities of this tool. Planned updates include:
- Multi-Site Support: Expanding the scraper's reach to seamlessly pull links from other popular character hubs.
Advanced Tag Filtering: Giving you the ability to filter out specific tags before scraping.- Date Filtering: Only scrape characters added within a specific timeframe.
List Management & Auto-Clear: Streamlining consecutive scraping sessions by adding a dedicated "Clear Links" button, or an option to automatically flush your saved list upon a successful copy.Dynamic Whitelist Editing: Giving you the power to remove specific creators from your active whitelist on the fly, complete with a smart prompt asking whether to keep or purge their already-scraped links.Direct .txt File Export: Bypassing mobile clipboard size limits entirely by adding a button to download your massive link lists directly as a clean text file.- Granular Scrape Stats: Adding visual counters next to the creators' names in the UI so you can see exactly how many links were harvested from each specific author.
(Want to test the newest features before anyone else? Check out the CHANGELOG.md for instructions on how to install the Bleeding Edge Dev Build! Caution: very unstable and might not work from time to time!)
- 🥸 Check out the
CHANGELOG.mdto read the epic, 40+ version saga of how I engineered this tool to beat mobile browser limitations! - ℹ️ Disclaimer: This is a client-side tool for personal use. It simply automates the process of copying visible links. Please use responsibly and respect the servers of the sites you are scraping.