A collection of scripts for programmatically interacting with ExpertVoice.
- python3
- see requirements.txt
See config.json.example for an example configuration file.
Generates a CSV file of the entire ExpertVoice inventory. CSV entries contain the following values:
- brand
- name
- price
- MSRP (according to ExpertVoice)
- category (Apparel, Accessories, etc.)
Note - as of writing (2023-11-27), ExpertVoice will return an HTTP 500 if you attempt to request product information past the 10,000th element in a given category. The solution to this (while it remains broken on EV's side) is to use nested categories when a given category exceeds 10,000 products. The depth parameter in this script is currently hard-coded to 6 to reveal all subcategories. Any value higher than 6 will cause EV to respond with an HTTP 500. Classic.
| Short Name | Long Name | Type | Description |
|---|---|---|---|
-o |
--out-path |
str |
The path at which to save the products CSV. Defaults to ./out.csv |
| N/A | --config |
str |
Path to config file - defaults to ./config.json |
This script executes a query as specified by the user, and logs and results that haven't been seen before. productCode is used to track listings. "Seen listings" are tracked globally across all queries, so you should only be alerted once about a given item.
Queries are JSON objects that can contain any combination of parameters that ExpertVoice's search function allows. Taken from ExpertvoiceClient's search_products method, the possible parameters are as follows:
search_term: str = "",
genders: Optional[List[str]] = None,
brands: Optional[List[int]] = None,
category_id: Optional[int] = None,
promotion_extra_savings: bool = False,
promotion_free_shipping: bool = False,
promotion_friends_and_family: bool = False,
promotion_outlet: bool = False,
promotion_flash_deal: bool = False,
hide_out_of_stock: bool = False,
genders may include the following values:
Men's
Women's
Youth
Unisex
Brand IDs may be obtained from product page URLs - they are the value after the final slash in the path. For example, the brand ID of this item is 76422.
https://www.expertvoice.com/product/salomon-mens-cross/76422?p=LC1871400
Query JSONs are destructed and passed as arguments to this function. See config.json.example for example queries of varying complexity.
| Short Name | Long Name | Type | Description |
|---|---|---|---|
-q |
--query-name |
str |
The name of the query to execute. This must be present in the list of queries |
| N/A | --all |
bool |
If set, execute all queries |
-l |
--list-queries |
bool |
If set, list all queries that can be executed and exit |
| N/A | --markdown |
bool |
If set, log URLs in markdown format (for gotify) |
| N/A | --config |
str |
Path to config file - defaults to ./config.json |
Discovers and unlocks all locked discounts that require passing a learning module campaign in ExpertVoice. Your account's unlockable deals can be found here.
If run without the --cheat-sheet argument, the script will use brute force to enumerate possible answers to questions.
If a cheat sheet is provided, correct answers will be attempted first, before falling back to brute force if the provided answer was incorrect/invalid.
The --save-cheat-sheet argument will save the entire cheat sheet - what was discovered during execution as well as the cheat sheet provided by the --cheat-sheet argument, if applicable - to a local JSON file.
The paths to --cheat-sheet and --save-cheat-sheet cannot be the same, as to view the cheat sheet in a read-only context.
My mostly complete cheat sheet can be found in this repo, but it may not be perfect! Please feel free to make PRs to update it.
| Short Name | Long Name | Type | Description |
|---|---|---|---|
| N/A | --cheat-sheet |
str |
If provided, the path to a local "cheat sheet" JSON to use for answer lookup |
| N/A | --save-cheat-sheet |
str |
If set, save the computed cheat sheet to the provided path after successfully passing quizzes |
| N/A | --config |
str |
Path to config file - defaults to ./config.json |