The Plugin uses PythonDepManager to install requirements on it’s own. git and pip must be installed for everything to work properly.
Config
Go into your Stash then under Settings > Plugins you’ll find the config for Bulk Image Scrape
It is mandatory to enter the Scraper ID of the Scraper you want to use. In this example SHALookup is used but you can use any valid Image Scraper that is installed in your Stash.
If the scraper returns a movie/group and it is not already in your stash, the plugin will create it if enabled
Create Missing performer from scrape result
If the scraper returns a performer and it is not already in your stash, the plugin will create it if enabled
Create Missing studios from scrape result
If the scraper returns a studio and it is not already in your stash, the plugin will create it if enabled
Exclude images that are set as organized
Any image that is set as organized will be skipped if enabled
Merge existingtags with scraped tags
Merge scraped tags with existing tags instead of overwriting them when enabled
The Scraper ID of the image scraper to use
Enter the ID of the scraper you want to use. If this is not set correctly the plugin will tell you in the logs when you run the plugin task
List of tags to skip
Any image that has one or more of the Tags from this setting will be skipped by the plugin if Tags are specified here. Multiple Tags must be comma separated. If the plugin can’t find a tag you specified it will notify you in the logs
SkipEntriesNum
Number of entries to skip over (mostly for rerunning after an error on large collections)
Task
After you adapted the config to your liking and made sure your image scraper of choice works properly simply start the task in Settings > Tasks
Posted in the Discord as well but I’m having an issue when trying to run this plugin.
[Plugin / Bulk Image Scrape] GRAPHQL_VALIDATION_FAILED: Field "fingerprint" argument "type" of type "String!" is required, but it was not provided.
2025-12-03 09:20:07Error [Plugin / Bulk Image Scrape] GRAPHQL_VALIDATION_FAILED: Field "fingerprint" argument "type" of type "String!" is required, but it was not provided.
2025-12-03 09:20:07Error [Plugin / Bulk Image Scrape] GRAPHQL_VALIDATION_FAILED: Field "fingerprint" argument "type" of type "String!" is required, but it was not provided.
Plugin / Bulk Image Scrape] 422 Unprocessable Entity query failed. v0.29.3-0 2025-12-03 09:20:07Error [Plugin / Bulk Image Scrape] 422 Unprocessable Entity GQL data response is null
The v0.29.3 mentioned earlier on is I’m guessing the stash version I’m running.
Edit: Interestingly if I clone the plugin repo, hardcode the FRAGMENT_SERVER value (to be the same as what the plugin itself is using) and run the script it appears to work against my stash instance.
