The official command-line client for spyse.com

Overview

Spyse CLI

The official command-line client for spyse.com.

NOTE: This tool is currently in the early stage beta and shouldn't be used in production.

Your feedback and suggestions are highly appreciated.

Supported Features

Targeted recon:

Gather associated targets:

Gather historical records

Custom Internet-wide assets search:

Installation

NOTE: Spyse API token is required to use this tool.

API tokens are available only for registered users on their account page.
For more information about the API, please check the API Reference.

Using Docker:

docker build -t spysecli .
echo "tesla.com" | docker run --interactive spysecli --api_token=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx subdomains

Using pip

pip3 install spysecli
spysecli --api_token=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -h 

# API token also can be read from environment
export SPYSE_API_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
spysecli -h

Using as a library

This repository is about CLI only. If you want to integrate spyse.com into your application, you should check out our SDKs.

Official:

Community:

Using the client

Targeted recon:

Get Domain details

Get DNS records, SSL/TLS certificate, structured HTTP response, technologies, potential vulnerabilities, and other details about domain by its name.

# Command example:
echo "tesla.com" | spysecli domain

# Examples of valid input lines:
domain.com
https://example.com
https://example.com/path

Get IPv4 host details

Get Open ports, autonomous system number/organization, ISP, technologies, ip reputation and abuse reports, structured HTTP response, potential vulnerabilities, and other details about IP address.

# Command example:
echo "8.8.8.8" | spysecli ip

# Examples of valid input lines:
8.8.8.8
8.8.8.0/24

Get Autonomous System details

Get associated organization, IPv4 prefixes, IPv6 prefixes, and other details about autonomous system.

# Command example:
echo "AS15169" | spysecli as

# Examples of valid input lines:
AS15169
as15169
15169

Get Email details

Get a list of sources in which an email was seen.

# Command example:
echo "[email protected]" | spysecli email

# Examples of valid input lines:
[email protected]

Gather associated targets:

Subdomains lookup

Find subdomains of a target domain

# Command example:
echo "tesla.com" | spysecli subdomains

# Examples of valid input lines:
domain.com
https://example.com
https://example.com/path

Reverse IP lookup

Find domains hosted on IPv4 host

# Command example:
echo "8.8.8.8" | spysecli reverse-ip

# Examples of valid input lines:
8.8.8.8
8.8.8.0/24

Reverse NS lookup

Shows which domains are using given name server

# Command example:
echo "ns1.google.com" | spysecli reverse-ns

# Examples of valid input lines:
ns1.domain.com

Reverse MX lookup

Shows which domains are using given mail server

# Command example:
echo "mx.google.com" | spysecli reverse-mx

# Examples of valid input lines:
mx.google.com

Reverse PTR lookup

Shows which IPv4 hosts are using given PTR record

# Command example:
echo "google.com" | spysecli reverse-ptr

# Examples of valid input lines:
domain.com

Reverse AdSense ID lookup

Find all domains sharing the same AdSense ID

# Command example:
echo "1234567891234567" | spysecli reverse-adsense

# Examples of valid input lines:
pub-1234567891234567
1234567891234567

Reverse iTunes ID lookup

Find all domains sharing the same iTunes app ID

# Command example:
echo "1188352635" | spysecli reverse-itunes

# Examples of valid input lines:
1188352635

Reverse Google Play ID lookup

Find all domains sharing the same Google Play app ID

# Command example:
echo "google.com" | spysecli reverse-google-play

# Examples of valid input lines:
domain.com

Reverse Google Analytics ID lookup

Find all domains sharing the same Google Analytics ID

# Command example:
echo "UA-12345-12" | spysecli reverse-google-analytics

# Examples of valid input lines:
UA-12345-12

Reverse Google Site Verification ID lookup

Find all domains sharing the same Google site verification code

# Command example:
echo "rXOxyZounnZasA8Z7oaD3c14JdjS9aKSWvsR1EbUSIQ" | spysecli reverse-google-site-verification

# Examples of valid input lines:
rXOxyZounnZasA8Z7oaD3c14JdjS9aKSWvsR1EbUSIQ

Reverse Email lookup

Find all websites mentioning the same email address on the homepage

# Command example:
echo "[email protected]" | spysecli reverse-email

# Examples of valid input lines:
[email protected]

Gather historical records

Get historical DNS A records

Get historical DNS A records

# Command example:
echo "google.com" | spysecli history-dns-a

# Examples of valid input lines:
domain.com

Get historical DNS AAAA records

Get historical DNS AAAA records

# Command example:
echo "google.com" | spysecli history-dns-aaaa

# Examples of valid input lines:
domain.com

Get historical DNS CNAME records

Get historical DNS CNAME records

# Command example:
echo "google.com" | spysecli history-dns-cname

# Examples of valid input lines:
domain.com

Get historical DNS TXT records

Get historical DNS TXT records

# Command example:
echo "google.com" | spysecli history-dns-txt

# Examples of valid input lines:
domain.com

Get historical DNS MX records

Get historical DNS MX records

# Command example:
echo "google.com" | spysecli history-dns-mx

# Examples of valid input lines:
domain.com

Get historical DNS NS records

Get historical DNS NS records

# Command example:
echo "google.com" | spysecli history-dns-ns

# Examples of valid input lines:
domain.com

Get historical WHOIS records

Get historical DNS WHOIS records

# Command example:
echo "google.com" | spysecli history-whois

# Examples of valid input lines:
domain.com

Custom search for domains

Returns a list of domains that matched the search query.

Use API docs and Spyse Advanced Search to craft your own request.

# Command example:
echo '{"search_params":[{"name":{"operator":"ends","value":".spyse.com"}}]}' | spysecli search-domains

Custom search for IPv4 hosts

Returns a list of IPv4 hosts that matched the search query.

Use API docs and Spyse Advanced Search to craft your own request.

# Command example:
echo '{"search_params":[{"open_port":{"operator":"eq","value":"22"}}]}' | spysecli search-ip
You might also like...
 NiceHash Python Library and Command Line Rest API
NiceHash Python Library and Command Line Rest API

NiceHash Python Library and Command Line Rest API Requirements / Modules pip install requests Required data and where to get it Following data is nee

 NiceHash Python Library and Command Line Rest API
NiceHash Python Library and Command Line Rest API

NiceHash Python Library and Command Line Rest API Requirements / Modules pip install requests Required data and where to get it Following data is nee

Python wrapper for Xeno-canto API 2.0. Enables downloading bird data with one command line

Python wrapper for Xeno-canto API 2.0. Enables downloading bird data with one command line. Supports multithreading

🐍 The official Python client library for Google's discovery based APIs.

Google API Client This is the Python client library for Google's discovery based APIs. To get started, please see the docs folder. These client librar

DEPRECATED - Official Python Client for the Discogs API

⚠️ DEPRECATED This repository is no longer maintained. You can still use a REST client like Requests or other third-party Python library to access the

The official Python client library for the Kite Connect trading APIs

The Kite Connect API Python client - v3 The official Python client for communicating with the Kite Connect API. Kite Connect is a set of REST-like API

Official Python client for the MonkeyLearn API. Build and consume machine learning models for language processing from your Python apps.

MonkeyLearn API for Python Official Python client for the MonkeyLearn API. Build and run machine learning models for language processing from your Pyt

A Pythonic client for the official https://data.gov.gr API.

pydatagovgr An unofficial Pythonic client for the official data.gov.gr API. Aims to be an easy, intuitive and out-of-the-box way to: find data publish

🐍 The official Python client library for Google's discovery based APIs.

Google API Client This is the Python client library for Google's discovery based APIs. To get started, please see the docs folder. These client librar

Comments
  • spyse.response.RateLimitError: too many requests

    spyse.response.RateLimitError: too many requests

    Hi,

    I have this error when I try to scan a domain or subdomains. echo tesla.com | spysecli --api_token=$SPYSE_API subdomains

    Traceback (most recent call last):
      File "/usr/local/bin/spysecli", line 8, in <module>
        sys.exit(cli())
      File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1128, in __call__
        return self.main(*args, **kwargs)
      File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1053, in main
        rv = self.invoke(ctx)
      File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1656, in invoke
        super().invoke(ctx)
      File "/usr/local/lib/python3.9/site-packages/click/core.py", line 1395, in invoke
        return ctx.invoke(self.callback, **ctx.params)
      File "/usr/local/lib/python3.9/site-packages/click/core.py", line 754, in invoke
        return __callback(*args, **kwargs)
      File "/usr/local/lib/python3.9/site-packages/bin/main.py", line 46, in cli
        client.fetch_account(f)
      File "/usr/local/lib/python3.9/site-packages/spysecli/client.py", line 23, in fetch_account
        callback_f(self.client.get_quotas())
      File "/usr/local/lib/python3.9/site-packages/spyse/client.py", line 106, in get_quotas
        response.check_errors()
      File "/usr/local/lib/python3.9/site-packages/spyse/response.py", line 117, in check_errors
        raise RateLimitError(m)
    spyse.response.RateLimitError: too many requests
    

    Any ideas ?

    opened by ghost 2
Releases(v0.1.6)
Owner
Spyse
Internet assets search engine
Spyse
Discord-RAID-Tool - Hacks/tools

How to use Python must be installed run install-config If you dont have python installed, download python 3.7.6 and make sure you click on the 'ADD TO

1 Jan 01, 2022
Provide fine-grained push access to GitHub from a JupyterHub

github-app-user-auth Provide fine-grained push access to GitHub from a JupyterHub. Goals Allow users on a JupyterHub to grant push access to only spec

Yuvi Panda 20 Sep 13, 2022
Discord Bot for server hosts, devs, and admins. Analyzes timings reports & uploads text files to hastebin. Developed by https://birdflop.com.

"Botflop" Click here to invite Botflop to your server. Current abilities Analyze timings reports Paste a timings report to review an in-depth descript

Purpur 76 Dec 31, 2022
Fix Twitter video embeds in Discord

TwitFix very basic flask server that fixes twitter embeds in discord by using youtube-dl to grab the direct link to the MP4 file and embeds the link t

Robin Universe 682 Dec 28, 2022
Plays air warning sound when detects a certain phrase or a word in a specified Telegram chat.

Tryvoha Bot Disclaimer: this is more a convenient naming, rather than a real bot. It is designed to play air warning sound when detects a certain phra

Dmytro Novikov 2 Mar 02, 2022
An interactive and multi-function Telegram bot, made especially for Telegram groups.

PyKorone An interaction and fun bot for Telegram groups, having some useful and other useless commands. Created as an experiment and learning bot but

Amano Team 17 Nov 12, 2022
A telegram bot that messages you available vaccine appointments in the Veneto region

Serenissimo, domande frequenti Chi sei? Sono Alberto Granzotto, libero professionista a Berlino. Mi occupo di servizi software, privacy, decentralizza

vrde 31 Sep 30, 2022
Is the CoWin website updated for registration?

CoWin-Update Is the CoWin website updated for registration? This is a very hacky PYTHON3 script to lookup the CoWin portal if they re-deployed their J

Yash Jakhotiya 5 May 10, 2021
GG Dorking is a tool to generate GitHub and Google dorking for pentesters and bug bounty hunters.

GG-Dorking GG Dorking is a python tool to generate GitHub and Google dorking links for pentesters and bug bounty hunters. It will help you to find imp

Eslam Akl 80 Nov 24, 2022
Discord bot that plays cricket with the user

CricBot Table of content Commands Installation Game rules License Commands S.No Command Use 1. cric Open the home window. This command is not necessa

Raveesh Yadav 1 Nov 19, 2021
fair-test is a library to build and deploy FAIR metrics tests APIs supporting the specifications used by the FAIRMetrics working group.

☑️ FAIR test fair-test is a library to build and deploy FAIR metrics tests APIs supporting the specifications used by the FAIRMetrics working group. I

Maastricht University IDS 6 Oct 30, 2022
Docker image for epicseven gvg qq chatbot based on Xunbot

XUN_Langskip XUN 是一个基于 NoneBot 和 酷Q 的功能型QQ机器人,目前提供了音乐点播、音乐推荐、天气查询、RSSHub订阅、使用帮助、识图、识番、搜番、上车、磁力搜索、地震速报、计算、日语词典、翻译、自我检查,权限等级功能,由于是为了完成自己在群里的承诺,一时兴起才做的,所

Xavier Xiong 2 Jun 08, 2022
Bagas Mirror&Leech Bot is a multipurpose Telegram Bot written in Python for mirroring files on the Internet to our beloved Google Drive. Based on python-aria-mirror-bot

- [ MAYBE UPDATE & ADD MORE MODULE ] Bagas Mirror&Leech Bot Bagas Mirror&Leech Bot is a multipurpose Telegram Bot written in Python for mirroring file

4 Nov 23, 2021
Flask-SQLAlchemy API for daisuki-web

💟 Anime Daisuki! API API de animes com cadastro de usuários. O usuário autenticado pode avaliar e favoritar animes, comentar episódios e verificar o

Paulo Thor 1 Nov 04, 2021
Discord Selfbot, 90+ commands

Setting the bot up. STEP 1: copy the directory yook.club selfbot was downloaded and extracted into, open cmd and type "cd " then paste. STEP 2: python

yook 1 Dec 12, 2021
Want to play What Would Rather on your Server? Invite the bot now! 😏

What is this Bot? 👀 What You Would Rather? is a Guessing game where you guess one thing. Long Description short Take this example: You typed r!rather

FSP Gang s' YT 3 Oct 18, 2021
Telegram Bot to check covid vaccine slot availability on CoWin site

Cowin Assist Telegram Bot Check the bot here @cowinassistbot. This is a simple Telegram bot to Check slots availability Get an alert when slots become

32 Jun 21, 2022
Discord Token Nuker With Python

Discord token nuker a.k.a A$$Fvcker Setup For installing the requirements do this: pip install -r requirements.txt To start the Token nuker run this

PR3C14D0 8 Sep 22, 2022
Weather_besac is a French twitter bot that tweet the weather of the city of Besançon in Franche-Comté in France every day at 8am and 4pm.

Weather Bot Besac Weather_besac is a French twitter bot that tweet the weather of the city of Besançon in Franche-Comté in France every day at 8am and

Rgld_ 1 Nov 15, 2021
Instagram Brute force attack helps you to find password of an instagram account from your list of provided password.

Instagram Brute force attack Instagram Brute force attack helps you to find password of an instagram account from your list of provided password. Inst

Naman Raj Singh 1 Dec 27, 2021