bbence84/market-scout

Market-scout is a command line tool for people hunting rare items, like old retro computers, vintage collectibles, or hard to find spare parts, across classifieds websites in many European countries at once. Instead of visiting twenty different local marketplace sites by hand and translating each search yourself, you type one search and the tool checks all of them together. It covers about twenty different sites across countries including Hungary, Germany, Austria, France, Italy, Poland, Czechia, Slovakia, Romania, Bulgaria, Ukraine, Portugal, and Spain, plus worldwide Facebook Marketplace. Because sellers in different countries often describe the same item differently, the tool can suggest alternative search terms, such as C64 or CBM 64 for a Commodore 64, and it can translate your search into the local language before running it. Results come back translated to your own language too, shown as a colour coded table in the terminal or saved as an HTML, JSON, CSV, or plain text file. One of the more distinctive features is an optional AI check on each listing. If you turn it on, the tool fetches the full description of a listing and asks a large language model a specific question you provide, for example whether a Commodore 64 listing is the actual computer or just spare parts, and gets back a YES, MAYBE, or NO answer along with a short explanation. Installation is done through pipx, a tool for installing Python command line programs in their own isolated environment, followed by a one time install of Chromium through Playwright, the browser automation library the scraper relies on. Some marketplaces, like Facebook or Polish Allegro, need a one time browser login or CAPTCHA solve before searching works. Developers who want to add support for a new country's marketplace can also run the project from source and follow a separate guide for adding new scraper providers. Overall this is a practical utility built for a specific hobby: finding rare secondhand items across borders without juggling a dozen browser tabs and translation apps.