Wiki: https://deepwiki.com/pyoneerC/Mercadix
Mercadix helps you quickly understand the price landscape for any product on Mercado Libre (Argentina & Brasil). Simply search for an item, and Mercadix generates a clear histogram showing the range of prices currently listed. This allows you to see the minimum, maximum, average, and median prices at a glance, helping you make informed decisions.
No technical knowledge required! Just type what you're looking for.
Mercadix is useful for:
- Small Business Owners & Retailers: Quickly check competitor pricing or understand the market value of products you sell or plan to sell.
- Resellers: Identify potentially underpriced items or gauge the typical selling price for products you want to flip.
- Informed Consumers: See if a listed price is a good deal compared to the rest of the market before you buy.
- Anyone curious about pricing trends on Mercado Libre.
Tip
Want to know the price range for "Smart TV 50 pulgadas"? Just search it!
- Easy Price Lookup: Enter the product name you want to analyze.
- Clear Visualizations: Get an easy-to-understand histogram of prices.
- Key Price Stats: Instantly see the average, median, highest, and lowest prices, plus the price variation (standard deviation).
- Product Image: See a sample image from the search results.
- Simple Interface: Designed for ease of use, no complex setup needed.
Tip
You can download the generated price graph image by clicking the "Download Image" button.
Mercadix searches Mercado Libre for the product you entered, collects the prices from the listings, and then uses statistical analysis and graphing tools (like Matplotlib) to create the visual price summary. It also uses the monedas-api for optional currency conversion insights (though the primary display is in local currency).
To run this project on your local machine, follow these steps:
- Clone the Repository:
git clone https://github.com/tu_usuario/mercado-libre-price-chart.git
- Install Dependencies:
Make sure you have Python and pip
installed on your system. Then, install the project dependencies with the following command:
pip install -r requirements.txt
- Set Up Environment Variables:
Create a .env
file in the root directory of the project and add the following variables:
FLASK_APP=app.py
FLASK_ENV=development
FLASK_DEBUG=0
- Run the Application:
Finally, run the application with the following command:
flask run
The application will be available at http://127.0.0.1:5000
Warning
Be cautious when requesting a high number of pages — the operation may take several seconds to complete.
Caution
Try to be as specific as possible with your search to get more accurate results. You can check the data source by clicking the "View on MercadoLibre" button.
To run backend tests, use the following command:
pytest tests/backend
To run frontend tests, use the following command:
npm test
To run E2E tests, use the following command:
npx playwright test
- Flask: Web framework for Python.
- Matplotlib: Library for creating visualizations.
- BeautifulSoup: Library for parsing HTML and extracting data.
- Requests: HTTP library for sending and receiving data.
- NumPy: Library for numerical computing in Python.
This is an open-source project, and contributions are welcome!
This project is licensed under the MIT License. For more information, see the LICENSE file.