a command line tool for assembling search engine links, specifically with the intention of searching multiple specific domains at once.
This is my first semi-serious development project, and even then it was mostly intended for practice. If you have advice or ideas to contribute after peeking at the code, please feel free to create a pull request &/or reach out. I think, at minimum, this could become somewhat useful to some folks. Contact information at the end of this file.
NOTE: replicant_search was built on Windows 10. It's built in Python, and as such should be at least near-runnable on other OSes. I did try to keep things in the source non-Windows-specific, even though the provided executables are Windows-only.
If you're running this from source, you can type "exit" in place of any input to quit the program.
"Development is only the most recent addition to a long list of hobbies for me, one of which is 3D printing. Some services (yeggi comes to mind) already exist to index results across multiple community repositories of 3D models for printing, but I wanted a little more than that. The list of indexed services is fixed, and sometimes I'd like to crawl multiple sites for something that isn't a .stl file. Google's Advanced Search page can accomplish a whole lot, but combining scope domains is less than simple. Hence, replicant_search was born!"
- Constructs + opens a Google or Google Images (only Google... for now) search link, aimed at a preset list of domains, from a typed query.
- Parses input 'scopes.json' and divides it into sets of URLs to search. These sets can be selected (and listed) from within the console.
- Windows executables are included, and do not require a Python installation.
- Scope set definition from the command line
- More search engines!
- GUI (depending on further research)
-
Download the latest version from the Releases page. Run the installer, which will unpack required files into a folder called r_search in the same location as the installer.
-
Open and edit the scopes.json file located inside r_search. A set, defined in curly braces, should contain an entry for a label and a list of links. Check out the examples for reference.
-
Run
replicant_search.exeto invoke the program. The command window will prompt you further!
Remember that you should rarely need a more specific URL than 'https://www.web.site/'. The search engine will look for results on all the subpages either way. The tool is currently only configured to parse ":" and "/" characters for the time being, so longer-form links with other special characters may cause errors.
Benjamin Adase / Hex Benjamin
website: https://hexbenjam.in/
email: [email protected]
discord: @hex benjamin#1738
README was last updated on 06/15/2022.