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
A Telegram bot to index Chinese and Japanese group contents, works with @lilydjwg/luoxu.

luoxu-bot luoxu-bot 是类似于 luoxu-web 的 CJK 友好的 Telegram Bot,依赖于 luoxu 所创建的后端。 测试环境 Python 3.7.9 pip 21.1.2 开发中使用到的 Telethon 需要 Python 3+ 配置 前往 luoxu 根据相

TigerBeanst 10 Nov 18, 2022
“ Hey there 👋 I'm Daisy „ AI based Advanced Group Management Bot Suit For All Your Needs ❤️.. Source Code of @Daisyxbot

Project still under heavy development Everything will be changed in the release “ Hey there 👋 I'm Daisy „ AI based Advanced telegram Group Management

TeamDaisyX 43 Nov 12, 2022
The official wrapper for spyse.com API, written in Python, aimed to help developers build their integrations with Spyse.

Python wrapper for Spyse API The official wrapper for spyse.com API, written in Python, aimed to help developers build their integrations with Spyse.

Spyse 15 Nov 22, 2022
Python API for working with RESQML models

resqpy: Python API for working with RESQML models Introduction resqpy is a pure python package which provides a programming interface (API) for readin

BP 44 Dec 14, 2022
Script to automatically book a vaccine slot on Doctolib for today or tomorrow, following rules from the French Government.

DOCTOSHOTGUN This script lets you automatically book a vaccine slot on Doctolib for today or tomorrow, following rules from the French Government. Pyt

Romain Bignon 560 Dec 19, 2022
This repository contains free labs for setting up an entire workflow and DevOps environment from a real-world perspective in AWS

DevOps-The-Hard-Way-AWS This tutorial contains a full, real-world solution for setting up an environment that is using DevOps technologies and practic

Mike Levan 1.6k Jan 05, 2023
A Twitter bot developed in Python using the Tweepy library and hosted in AWS.

Twitter Cameroon: @atangana_aron A Twitter bot developed in Python using the Tweepy library and hosted in AWS. https://twitter.com/atangana_aron Cost

1 Jan 30, 2022
Connects to a local SenseCap M1 Helium Hotspot and pulls API Data.

sensecap_api_checker_HELIUM Connects to a local SenseCap M1 Helium Hotspot and pulls API Data.

Lorentz Factr 1 Nov 03, 2021
WatonAPI is an API used to connect to spigot servers with the WatonPlugin to communicate.

WatonAPI is an API used to connect to spigot servers with the WatonPlugin to communicate. You can send messages to the server and read messages, making it useful for cross-chat programs.

Waton 1 Nov 22, 2021
A GitHub Action that automatically reports your Advent of Code progress in a table in your README

Advent README Stars This action adds and maintains a stars report in your README based on your Advent of Code progress. Example Table 2021 Results Day

Kevin Duff 36 Dec 30, 2022
A Python script that exports users from one Telegram group to another using one or more concurrent user bots.

ExportTelegramUsers A Python script that exports users from one Telegram group to another using one or more concurrent user bots. Make sure to set all

Fasil Minale 17 Jun 26, 2022
IdeasBot - Funny telegram bot to generate ideas for a project

Repository of PIdeas_bot About Funny telegram bot for generating projects ideas.

Just Koala 5 Oct 16, 2022
A google search telegram bot.

Google-Search-Bot A google search telegram bot. Made with Python3 (C) @FayasNoushad Copyright permission under MIT License License - https://github.c

Fayas Noushad 37 Nov 24, 2022
Cookiecutter templates for Serverless applications using AWS SAM and the Rust programming language.

Cookiecutter SAM template for Lambda functions in Rust This is a Cookiecutter template to create a serverless application based on the Serverless Appl

AWS Samples 24 Nov 11, 2022
A melhor maneira de atender seus clientes no Telegram!

Clientes.Chat Sobre o serviço Configuração Banco de Dados Variáveis de Ambiente Docker Python Heroku Contribuição Sobre o serviço A maneira mais organ

Gabriel R F 10 Oct 12, 2022
Python client for the iNaturalist APIs

pyinaturalist Introduction iNaturalist is a community science platform that helps people get involved in the natural world by observing and identifyin

Nicolas Noé 79 Dec 22, 2022
A free and open-source SMS/Call bombing application

TBOMB V0.1 A free and open-source SMS/Call bombing application NOTE: For Termux To use the bomber type the following commands in Termux: pkg install g

ᴀɴᴋɪᴛ ᴋᴜᴍᴀʀ 2 Dec 07, 2021
Yes, it's true :yellow_heart: This repository has 326 stars.

Yes, it's true! Inspired by a similar repository from @RealPeha, but implemented using a webhook on AWS Lambda and API Gateway, so it's serverless! If

510 Dec 28, 2022
Posts word definitions on Twitter daily

Word Of The Day bot Post daily word definitions on social media. Twitter account: https://twitter.com/WordOfTheDay_B Introduction The goal of this pro

Lucas Rijllart 1 Jan 08, 2022
TFT Bot that automatically surrenders and allows finishing TFT Passes easily.

Image Based TFT Bot TFT Bot that automatically surrenders and allows finishing TFT Passes easily. Please read full file! You can check new releases he

1 Feb 06, 2022