Unlock Shodan API: Boost Your Ansible Automation with Powerful Modules

Ansible Shodan Modules #

This 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.

Modules #

This collection includes the following modules:

• get_shodan_api_info : Returns information about the API plan linked to the given API key.
• get_shodan_client_http_headers : Shows the HTTP headers that your client sends when connecting to a web server.
• get_shodan_client_ip : Get your current IP address as seen from the Internet.
• See more at the modules directory..

Installation #

You can install this collection using the following command:

ansible-galaxy collection install simeononsecurity.ansible_shodan

See the collection on the Ansible Galaxy page.

Usage #

To 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:

---
- name: Get Shodan API Info
  hosts: localhost
  tasks:
    - name: Get Shodan API Info
      simeononsecurity.ansible_shodan.get_shodan_api_info:
        api_key: your_shodan_api_key
      register: shodan_api_info

    - name: Display API Info
      debug:
        var: shodan_api_info

Contributing #

Contributions 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.

License #

This project is licensed under the MIT License. See the LICENSE file for details.

Author #

This Ansible Shodan Modules collection is authored by SimeonOnSecurity .

Acknowledgments #

Special thanks to the Shodan API for providing the capabilities to interact with their service using Ansible.