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
Python API for British Geological Survey magnetic field calculator

Magnetic field calculator Python API for British Geological Survey magnetic field calculator. Description This project magnetic field calculator. It u

Filip Š 3 Mar 11, 2022
An Simple Advance Auto Filter Bot Complete Rewritten Version Of Adv-Filter-Bot

Adv Auto Filter Bot V2 This Is Just An Simple Advance Auto Filter Bot Complete Rewritten Version Of Adv-Filter-Bot.. Just Sent Any Text As Query It Wi

0 Dec 18, 2021
This is a scalable system that reads messages from public Telegram channels using Telethon and stores the data in a PostgreSQL database.

This is a scalable system that reads messages from public Telegram channels using Telethon and stores the data in a PostgreSQL database. Its original intention is to monitor cryptocurrency related ch

Greg 3 Jun 07, 2022
Discord bot that displays the current Swatch Internet Time (.beat) as a status.

Internet-Time-Display Discord bot that displays the current Swatch Internet Time (.beat) as a status. Visit the website! Add the bot to your server! A

2 Mar 15, 2022
Remedy when Amazon ECR is not running basic scans for container CVEs.

Welcome to your CDK Python project! This is a blank project for Python development with CDK. The cdk.json file tells the CDK Toolkit how to execute yo

4n6ir 4 Nov 05, 2022
A Sublime Text plugin that displays inline images for single-line comments formatted like `// ![](example.png)`.

Inline Images Sometimes ASCII art is not enough. Sometimes an image says more than a thousand words. This Sublime Text plugin can display images inlin

Andreas Haferburg 8 Jul 01, 2022
Telegram Bot for everyday raffles

SpinEverydayBot v2 Telegram bot for everyday raffles. HIGHLY EXPERIMENTAL! WORK IN PROGRESS! Setting up Requirements Python 3.9+ PostgreSQL 13+ Older

evgfilim1 18 Dec 20, 2022
Asad Alexa VC Bot Is A Telegram Bot Project That's Allow You To Play Audio And Video Music On Telegram Voice Chat Group.

Asad Alexa VC Bot Is A Telegram Bot Project That's Allow You To Play Audio And Video Music On Telegram Voice Chat Group.

Dr Asad Ali 6 Jun 20, 2022
Multi-Branch CI/CD Pipeline using CDK Pipelines.

Using AWS CDK Pipelines and AWS Lambda for multi-branch pipeline management and infrastructure deployment. This project shows how to use the AWS CDK P

AWS Samples 36 Dec 23, 2022
Discord bot that performs various functions.

rikka-bot A Discord bot that performs various functions. Table of Contents Commands Main Commands Utility Commands Admin Commands Self-Assignable Role

Carlos Saucedo 7 Aug 27, 2021
WhatsApp Status Tracker With Python

Warning!! This Repo is Purly educational purpose Don't use this to stalk on others, which is subjective to crime Pre-Req: Telegram bot of your own wit

Vignesh Karunagaran 10 Dec 09, 2022
A Video Streaming Telegram Bot written in Python with Pyrogram and PyTgcalls

Video Stream Bot A Video Streaming Telegram Bot written in Python using Pyrogram and PyTgcalls Requirements Python 3.9 Telegram API Telegram Bot Token

Aarav Arora 61 Dec 10, 2022
Python SDK for IEX Cloud

iexfinance Python SDK for IEX Cloud. Architecture mirrors that of the IEX Cloud API (and its documentation). An easy-to-use toolkit to obtain data for

Addison Lynch 640 Jan 07, 2023
A discord account nuker with lots of tools that will destroy a discord account

A discord account nuker with lots of tools that will destroy a discord account (token destroyer... and much more).

firexi 10 Apr 28, 2022
A discord self-bot to automate shitposting for your everyday needs.

Shitpost Selfbot A discord self-bot to automate shitposting for your everyday needs. Caution: May be a little racist. I have no clue where we are taki

stormy 1 Mar 31, 2022
Aws-cidr-finder - A Python CLI tool for finding unused CIDR blocks in AWS VPCs

aws-cidr-finder Overview An Example Installation Configuration Contributing Over

Cooper Walbrun 18 Jul 31, 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
Discord Token Checker and Info

Discord Token Checker A simple way to check Discord user tokens and their info in bulk. By Roover#7098. https://discord.gg/W8hnMWY6XP Proxy support co

Roover 3 Dec 09, 2021
Roblox-Account-Gen - A simple account generator not using paid solving services

Roblox Account Generator Star this if it helped to spread awareness! No 2captcha

x 1 Feb 17, 2022
Discord Voice Channel Automatic Online

Discord-Selfbot-voice Features: Discord Voice Channel Automatic Online FAQ Q: How can I obtain my token? A: 1. How to obtain your token in android 2.

Pranav Ajay 3 Oct 31, 2022