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
Black-hat with python

black-hat_python Advantages - More advance tool Easy to use allows updating tool update - run bash update.sh Here -: Command to install tool main- clo

Hackers Tech 2 Feb 10, 2022
Python API Client for Twitter API v2

๐Ÿ Python Client For Twitter API v2 ๐Ÿš€ Why Twitter Stream ? Twitter-Stream.py a python API client for Twitter API v2 now supports FilteredStream, Samp

Twitivity 31 Nov 19, 2022
Lumi-Bot - Discord bot that fetches cryptocurrency prices utilizing CoinGeko API

Lumi-Bot Discord bot that fetches and monitors cryptocurrency prices utilizing C

Diego Castro 2 Oct 08, 2022
The AWS Lambda Serverless Blind XSS App

Ass The AWS Lambda Serverless Blind XSS App ๅˆฉ็”จVPS้…็ฝฎXSSๅนณๅฐๅคช้บป็ƒฆไบ†๏ผŒๅฆ‚ๆžœๅˆฉ็”จAWS็š„Lambda้‚ฃไธๅฐฑๆ˜ฏไธ€ไธชๅŸŸๅ็š„ไบ‹ๆƒ…ไนˆ๏ผŸๅ‰ฉไธ‹็š„็Žฏๅขƒ้…็ฝฎใ€HTTPS่ฏไนฆใ€้š็งๆ€งใ€VPS็ปญ่ดน้ƒฝไธ็”จ็ฎกไบ†๏ผŒ ๆ‰€ไปฅๆ นๆฎxless้‡ๅ†™ไบ†Lambdaๅนณๅฐ็š„XSS๏ผŒๅˆฉ็”จsla

cocokey 2 Dec 27, 2021
Droplink URL Shortener Bot, deployable to Heroku and Railway.

Droplink-bot Make short link by using Droplink API key. Made by @dakshy. Installation The Easy Way Required Variables BOT_TOKEN: Create a bot using @B

ToonsHub 5 Jun 25, 2022
twitter bot tha uses tweepy library class to connect to TWITTER API

TWITTER-BOT-tweepy- twitter bot that uses tweepy library class to connect to TWITTER API replies to mentions automatically and follows the tweet.autho

Muziwandile Nkomo 2 Jan 08, 2022
A Discord bot written in Python to help with guild administration

forgotten-hydra A Discord bot written in Python to help with guild administration. External libraries Pycord-Development/pycord 1.7.3 djc/couchdb-pyth

1 May 14, 2022
Sniper for Anigame and Izzi discord bots!

Anigame Sniper Gen-3 Features Inbuilt Spammer Responds to your messages in discord (on/off) Snipes only where you want it to Set latency so that the b

22 Nov 13, 2022
Python client for numerbay.ai - the Numerai community marketplace

NumerBay Python API Programmatic interaction with numerbay.ai - the Numerai community marketplace. If you encounter a problem or have suggestions, fee

Numerai Council of Elders 5 Nov 30, 2022
Simple, yet effective moderator bot for telegram. With reports, logs, profanity filter and more :3

๐Ÿ‘น Samurai Telegram Bot Simple, yet effective moderator bot for telegram. With reports, logs, profanity filter and more :3 Description Personal bot, m

Abraham Tugalov 106 Dec 13, 2022
This repo provides the source code for "Cross-Domain Adaptive Teacher for Object Detection".

Cross-Domain Adaptive Teacher for Object Detection This is the PyTorch implementation of our paper: Cross-Domain Adaptive Teacher for Object Detection

Meta Research 91 Dec 12, 2022
EduuRobot Telegram bot source code.

EduuRobot A multipurpose Telegram Bot made with Pyrogram and asynchronous programming. Requirements Python 3.6+ An Unix-like operating system (Running

Amano Team 119 Dec 23, 2022
โ๐“๐ก๐ž ๐Œ๐จ๐ฌ๐ญ ๐๐จ๐ฐ๐ž๐ซ๐Ÿ๐ฎ๐ฅ๐ฅ ๐†๐ซ๐จ๐ฎ๐ฉ ๐Œ๐š๐ง๐š๐ ๐ž๐ฆ๐ž๐ง๐ญ ๐๐จ๐ญโž

โ๐“๐ก๐ž ๐Œ๐จ๐ฌ๐ญ ๐๐จ๐ฐ๐ž๐ซ๐Ÿ๐ฎ๐ฅ๐ฅ ๐†๐ซ๐จ๐ฎ๐ฉ ๐Œ๐š๐ง๐š๐ ๐ž๐ฆ๐ž๐ง๐ญ ๐๐จ๐ญโž

Abdisamad Omar Mohamed 5 Jun 24, 2022
"zpool iostats" for humans; find the slow parts of your ZFS pool

Getting the gist of zfs statistics vpool-demo.mp4 The ZFS command "zpool iostat" provides a histogram listing of how often it takes to do things in pa

Chad 57 Oct 24, 2022
Joins a specified server on all the tokens

Joins a specified server on all the tokens. Usage python -m pip install requests python joiner.py Note Your tokens must be located in a text file call

1 Dec 21, 2021
Python Wrapper for handling payment requests through the Daraja MPESA API

Python Daraja Description Python Wrapper for handling payment requests through the Daraja MPESA API Contribution Refer to the CONTRIBUTING GUIDE. Usag

William Otieno 18 Dec 14, 2022
Messing around with GitHub API to look at omicron build times

gh-workflow-runs This is a very simple tool to dump out basic information about workflow runs for a GitHub repo. The structure is based on gh-subscrip

David Pacheco 1 Nov 30, 2021
Texting service to receive current air quality conditions and maps, powered by AirNow, Twilio, and AWS

The Air Quality Bot is generally available by texting a zip code (and optionally the word "map") to (415) 212-4229. The bot will respond with the late

Alex Laird 8 Oct 16, 2022
API Wrapper in Python for WeebyAPI

API Wrapper in Python for WeebyAPI

ashish 3 Feb 28, 2022
Declarative assertions for AWS

AWSsert AWSsert is a Python library providing declarative assertions about AWS resources to your tests. Installation Use the package manager pip to in

19 Jan 04, 2022