{"id":34094966,"url":"https://github.com/jbjulia/mcc-mnc","last_synced_at":"2026-04-02T03:50:43.421Z","repository":{"id":56848620,"uuid":"378509502","full_name":"jbjulia/mcc-mnc","owner":"jbjulia","description":"A published Python package for country network queries, used for mobile subscriber identification.","archived":false,"fork":false,"pushed_at":"2023-06-13T04:58:23.000Z","size":53,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-23T13:52:30.700Z","etag":null,"topics":["beautifulsoup","cc","cdma","gsm","imsi","mcc","mcc-mnc","mnc","mobile","plmn","tqdm","umts"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/mccmnc/3.3/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jbjulia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-06-19T21:43:29.000Z","updated_at":"2025-07-06T09:07:54.000Z","dependencies_parsed_at":"2022-08-27T04:11:23.498Z","dependency_job_id":null,"html_url":"https://github.com/jbjulia/mcc-mnc","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jbjulia/mcc-mnc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbjulia%2Fmcc-mnc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbjulia%2Fmcc-mnc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbjulia%2Fmcc-mnc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbjulia%2Fmcc-mnc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jbjulia","download_url":"https://codeload.github.com/jbjulia/mcc-mnc/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jbjulia%2Fmcc-mnc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28124755,"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","status":"online","status_checked_at":"2025-12-30T02:00:05.476Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["beautifulsoup","cc","cdma","gsm","imsi","mcc","mcc-mnc","mnc","mobile","plmn","tqdm","umts"],"created_at":"2025-12-14T15:06:42.669Z","updated_at":"2025-12-30T08:04:26.274Z","avatar_url":"https://github.com/jbjulia.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mcc-mnc\n\nmcc-mnc is a tool for matching and retrieving information about Mobile Country Codes (MCC) and Mobile Network Codes (\nMNC). It allows you to search for MCC-MNC combinations, Country Codes (CC), Public Land Mobile Network (PLMN), or\nindividual MCC, MNC, or CC values to retrieve details about the corresponding mobile network provider. The tool uses a\nJSON database that maps the MCC-MNC combinations to their associated information such as ISO country codes, country\nnames, and network names.\n\n## Installation\n\nYou can install mcc-mnc using pip, the Python package manager.\n\n```bash\npip install mccmnc\n```\n\n## Usage\n\nYou can use mcc-mnc to search for MCC-MNC combinations, Country Codes (CC), PLMNs, or individual MCC, MNC, or CC values.\nHere are some usage examples:\n\n```bash\n# Search by Country Code (CC)\nmccmnc -cc XXX\n\n# Search by Mobile Country Code (MCC)\nmccmnc -mcc XXX\n\n# Search by MCC and MNC\nmccmnc -mcc XXX -mnc XXX\n\n# Search by CC, MCC, and MNC\nmccmnc -cc XXX -mcc XXX -mnc XXX\n\n# Search by PLMN\nmccmnc -plmn XXXXX\n\n# Update the mcc-mnc database\nmccmnc -update\n```\n\nThe `-update` option allows you to download and refresh the local JSON file that mcc-mnc uses for matching.\n\n## Python Usage\n\nYou can also use `mccmnc` within your Python programs. First, make sure it's installed in your Python environment, then\nyou can import it and use its functions. Here's an example:\n\n```python\nfrom mccmnc import find_matches, print_matches, update\n\n# Example of searching by MCC and MNC\nmatches = find_matches(user_mcc=\"123\", user_mnc=\"45\")\nif matches:\n    print_matches(matches)\nelse:\n    print(\"No match found.\")\n\n# Example of updating the database\nupdate()\n```\n\nThese examples demonstrate how to use `find_matches` to search for MCC-MNC combinations and `print_matches` to print out\nthe details of the matches. The `update` function is used to update the MCC-MNC database.\n\n## Contributing\n\nContributions, bug reports, and feature requests are welcome! If you would like to contribute to mcc-mnc, please open an\nissue to discuss your ideas or submit a pull request with your changes.\n\nPlease ensure that you update or add relevant tests for your changes.\n\n## License\n\nmcc-mnc is licensed under the [MIT License](https://choosealicense.com/licenses/mit/). Feel free to use, modify, and\ndistribute this project under the terms of this license.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjbjulia%2Fmcc-mnc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjbjulia%2Fmcc-mnc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjbjulia%2Fmcc-mnc/lists"}