{"id":25332441,"url":"https://github.com/stanfrbd/check_ip","last_synced_at":"2025-04-08T07:45:46.202Z","repository":{"id":240957329,"uuid":"803862652","full_name":"stanfrbd/check_ip","owner":"stanfrbd","description":"A CLI OSINT tool to check IP address using ipinfo official API and spur.us (free tier) - 5000 queries a month). ","archived":false,"fork":false,"pushed_at":"2024-05-31T08:40:36.000Z","size":13,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-14T04:52:13.311Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"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/stanfrbd.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}},"created_at":"2024-05-21T14:06:19.000Z","updated_at":"2024-11-08T22:11:25.000Z","dependencies_parsed_at":"2024-05-31T10:10:11.309Z","dependency_job_id":null,"html_url":"https://github.com/stanfrbd/check_ip","commit_stats":null,"previous_names":["stanfrbd/check_ip"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stanfrbd%2Fcheck_ip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stanfrbd%2Fcheck_ip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stanfrbd%2Fcheck_ip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stanfrbd%2Fcheck_ip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stanfrbd","download_url":"https://codeload.github.com/stanfrbd/check_ip/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247801185,"owners_count":20998331,"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":[],"created_at":"2025-02-14T04:52:15.295Z","updated_at":"2025-04-08T07:45:46.160Z","avatar_url":"https://github.com/stanfrbd.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# check_ip\n\nThis is a simple python script that checks IPinfo and spur.us for information about an IP address.\nIt helps to identify the location of the IP address, the organization that owns the IP address, the IP address's ASN and if it is associated with a known threat or commercial VPN.\n\n# Getting Started\n\n* To get started, clone the repository and install the requirements.\n\nYou might want to create a [`venv`](https://docs.python.org/3/library/venv.html) before installing the dependencies.\n\n```bash\npip install -r requirements.txt\n```\n\n## Edit the config file\n```\ncp secrets-sample.json secrets.json\n```\n\n* Fill the optionnal values (including proxy if needed) in the `secrets.json` file. This values will be useful for `spur_us_api.py` script. It is optional to fill the `ipinfo_token` value, but it is recommended to fill it to avoid rate limit.\n\n```json\n{\n    \"spur_email\": \"youruser@example.com\",\n    \"spur_password\": \"yourpassword\",\n    \"ipinfo_token\": \"token\",\n    \"proxy_url\": \"\"\n}\n```\n\n**Note:** if you don't have any account or token to use, try out the `check_ip_free.py` script, that doesn't require any token or account, only proxy if needed. It may have a lot of limitations in terms of requests and information (e.g. IP blocked or rate limit).\n\n## Usage\n\n```bash\npython3 check_ip.py -h\nusage: check_ip.py [-h] [-a IP] [-i INPUT_FILE]\n\nGet IP information\n\noptions:\n  -h, --help            show this help message and exit\n  -a IP, --ip-address IP\n                        IP address to check\n  -i INPUT_FILE, --input-file INPUT_FILE\n                        File containing IP addresses to check\n```\n\n## Tests\n\n```bash\npython3 check_ip.py -i tests/tests.txt\n```\n\n* Output\n\n```\n+-------------------+--------------------------+\n|        Key        |          Value           |\n+-------------------+--------------------------+\n|         IP        |         1.1.1.1          |\n|        City       |        The Rocks         |\n|       Region      |     New South Wales      |\n|      Country      |            AU            |\n|      Location     |    -33.8592,151.2081     |\n|        ISP        | AS13335 Cloudflare, Inc. |\n|       Postal      |           2000           |\n|      Timezone     |     Australia/Sydney     |\n| VPN Vendor (Spur) |      Not Anonymous       |\n+-------------------+--------------------------+\n\n+-------------------+----------------------------+\n|        Key        |           Value            |\n+-------------------+----------------------------+\n|         IP        |       45.154.138.91        |\n|        City       |         Marseille          |\n|       Region      | Provence-Alpes-Côte d'Azur |\n|      Country      |             FR             |\n|      Location     |       43.2970,5.3811       |\n|        ISP        |   AS206092 IPXO LIMITED    |\n|       Postal      |           13000            |\n|      Timezone     |        Europe/Paris        |\n| VPN Vendor (Spur) |        Express VPN         |\n+-------------------+----------------------------+\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstanfrbd%2Fcheck_ip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstanfrbd%2Fcheck_ip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstanfrbd%2Fcheck_ip/lists"}