{"id":14984495,"url":"https://github.com/simeononsecurity/ansible_shodan","last_synced_at":"2025-07-05T04:05:08.783Z","repository":{"id":188818383,"uuid":"679500076","full_name":"simeononsecurity/ansible_shodan","owner":"simeononsecurity","description":"A collection of shodan modules for ansible","archived":false,"fork":false,"pushed_at":"2024-07-26T23:02:23.000Z","size":33,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-24T18:11:25.247Z","etag":null,"topics":["ansible","ansible-collection","ansible-galaxy","ansible-modules","ansible-playbook","ansible-role","ansible-roles","shodan","shodan-api","shodan-cli","shodan-python"],"latest_commit_sha":null,"homepage":"https://simeononsecurity.com","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/simeononsecurity.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["simeononsecurity"],"custom":["https://simeononsecurity.com","https://simeononsecurity.com/recommendhome","https://simeononsecurity.com/affiliate","https://twitter.com/simeonsecurity","https://discord.io/cybersentinels"]}},"created_at":"2023-08-17T01:50:07.000Z","updated_at":"2024-07-26T23:02:27.000Z","dependencies_parsed_at":"2024-07-27T00:21:05.619Z","dependency_job_id":null,"html_url":"https://github.com/simeononsecurity/ansible_shodan","commit_stats":{"total_commits":26,"total_committers":1,"mean_commits":26.0,"dds":0.0,"last_synced_commit":"ee3d2e031bd63f997812651f372d84f14a7e7df6"},"previous_names":["simeononsecurity/ansible_shodan"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simeononsecurity%2Fansible_shodan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simeononsecurity%2Fansible_shodan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simeononsecurity%2Fansible_shodan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simeononsecurity%2Fansible_shodan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simeononsecurity","download_url":"https://codeload.github.com/simeononsecurity/ansible_shodan/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248290044,"owners_count":21078923,"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":["ansible","ansible-collection","ansible-galaxy","ansible-modules","ansible-playbook","ansible-role","ansible-roles","shodan","shodan-api","shodan-cli","shodan-python"],"created_at":"2024-09-24T14:09:09.895Z","updated_at":"2025-04-10T20:34:19.805Z","avatar_url":"https://github.com/simeononsecurity.png","language":"Python","funding_links":["https://github.com/sponsors/simeononsecurity","https://simeononsecurity.com","https://simeononsecurity.com/recommendhome","https://simeononsecurity.com/affiliate","https://twitter.com/simeonsecurity","https://discord.io/cybersentinels"],"categories":["Integrations and plugins"],"sub_categories":[],"readme":"# Ansible Shodan Modules\n\n[![Sponsor](https://img.shields.io/badge/Sponsor-Click%20Here-ff69b4)](https://github.com/sponsors/simeononsecurity) \n![Ansible](https://img.shields.io/badge/ansible-2.10%2B-blue)\n![License](https://img.shields.io/badge/license-MIT-green)\n\nThis collection provides Ansible modules for interacting with the Shodan API. The modules allow you to perform various tasks related to Shodan, such as querying information, searching for hosts, and more.\n\n## Modules\n\nThis collection includes the following modules:\n\n- [`get_shodan_api_info`](https://github.com/simeononsecurity/ansible_shodan/blob/main/collections/ansible_collections/simeononsecurity/shodan/plugins/modules/get_shodan_api_info.py): Returns information about the API plan linked to the given API key.\n- [`get_shodan_client_http_headers`](https://github.com/simeononsecurity/ansible_shodan/blob/main/collections/ansible_collections/simeononsecurity/shodan/plugins/modules/get_shodan_client_http_headers.py): Shows the HTTP headers that your client sends when connecting to a web server.\n- [`get_shodan_client_ip`](https://github.com/simeononsecurity/ansible_shodan/blob/main/collections/ansible_collections/simeononsecurity/shodan/plugins/modules/get_shodan_client_ip.py): Get your current IP address as seen from the Internet.\n- See more at the [modules directory..](https://github.com/simeononsecurity/ansible_shodan/tree/main/collections/ansible_collections/simeononsecurity/shodan/plugins/modules)\n\n\n## Installation\n\nYou can install this collection using the following command:\n\n```bash\nansible-galaxy collection install simeononsecurity.ansible_shodan\n```\n\nSee the collection on the [Ansible Galaxy](https://galaxy.ansible.com/simeononsecurity/ansible_shodan) page.\n\n## Usage\nTo use these modules, include them in your Ansible playbooks or roles and reference them using their respective names. Here's an example playbook using the `get_shodan_api_info` module:\n```yml\n---\n- name: Get Shodan API Info\n  hosts: localhost\n  tasks:\n    - name: Get Shodan API Info\n      simeononsecurity.ansible_shodan.get_shodan_api_info:\n        api_key: your_shodan_api_key\n      register: shodan_api_info\n\n    - name: Display API Info\n      debug:\n        var: shodan_api_info\n```\n\nYou can find [examples of all the `ansible shodan` modules used as playbooks](https://github.com/simeononsecurity/ansible_shodan/tree/main/collections/ansible_collections/simeononsecurity/shodan/playbooks).\n\n## Contributing\nContributions to this collection are welcome! If you have improvements or new modules to add, please fork this repository, create a new branch, and submit a pull request.\n\n## License\nThis project is licensed under the MIT License. See the [`LICENSE`](https://github.com/simeononsecurity/ansible_shodan/blob/main/LICENSE) file for details.\n\n## Author\nThis Ansible Shodan Modules collection is authored by [SimeonOnSecurity](https://simeononsecurity.com/).\n\n## Acknowledgments\nSpecial thanks to the Shodan API for providing the capabilities to interact with their service using Ansible.\n\n## Alternate Versions\n### PowerShell\nIf you need a version in powershell, we have our [Shodan Powershell repo](https://github.com/simeononsecurity/Shodan_PS).\n\n\u003ca href=\"https://simeononsecurity.com\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e\n  \u003ch2\u003eExplore the World of Cybersecurity\u003c/h2\u003e\n\u003c/a\u003e\n\u003ca href=\"https://simeononsecurity.com\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e\n  \u003cimg src=\"https://simeononsecurity.com/img/banner.png\" alt=\"SimeonOnSecurity Logo\" width=\"300\" height=\"300\"\u003e\n\u003c/a\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimeononsecurity%2Fansible_shodan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimeononsecurity%2Fansible_shodan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimeononsecurity%2Fansible_shodan/lists"}