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.