Skip to content
View phoneintel's full-sized avatar
📱
Investigating....
📱
Investigating....

Block or report phoneintel

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Please don't include any personal information such as legal names or email addresses. Maximum 100 characters, markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
phoneintel/README.md

PhoneIntel - Transforming Phone Number Intelligence

PyPI version GitHub issues GitHub pull-requests GitHub forks GitHub license GitHub contributors GitHub stars Language: Python

Introduction

Welcome to PhoneIntel, your ultimate open-source solution for harnessing the power of phone number intelligence. Designed for OSINT enthusiasts and professionals, PhoneIntel is an advanced tool that enables you to search and analyze comprehensive information about phone numbers, empowering you with insights at your fingertips.

With PhoneIntel, uncover essential details about phone numbers, including country, area or state, carrier information, and more. Seamlessly handle multiple phone numbers, generate precise Google dorks for social media, forums, classified ads sites, and map locations directly on OpenStreetMap.

Key Features

  • In-Depth Phone Number Analysis: Gain detailed insights such as country, area or state, and carrier information.
  • Batch Processing: Effortlessly analyze multiple phone numbers from a text file.
  • Google Dork Generation: Create URL-encoded Google dorks tailored to specific categories.
  • Location Mapping: Visualize phone number locations on OpenStreetMap with the --map option.
  • Tellows Integration: Access additional data from Tellows, including URL, score, and call type.
  • SpamCalls Integration: Extract spam risk, last activity, and the latest report of phone numbers from SpamCalls.net.
  • c-qui.fr Integration: Extract french carriers and number of number requests. c-qui.fr.
  • Neutrino API Integration: Authenticate, search, and map phone number information using the Neutrino API.

Installation

  1. Run the following command.

    pip install phoneintel

For Kali Linux Users

Remember to add the Directory to PATH:

export PATH=$PATH:/home/<username>/.local/bin

Getting Started

Single Phone Number Lookup

Discover detailed information about a specific phone number:

phoneintel --info +34613814500

Multiple Phone Numbers from a String

Analyze multiple phone numbers embedded within a text string:

phoneintel --search --string "My number is +16148077641 but you can call me at +34613814500"

Batch Analysis from a Text File

Process multiple phone numbers listed in a text file:

phoneintel --search --input ./example.txt

OpenStreetMap Location Mapping

View the location of a phone number on OpenStreetMap:

phoneintel --info "+34613814500" --map

Generate Google Dorks

Create targeted Google dorks for various categories:

phoneintel "+34613814500" --dorks --type social_networks

Neutrino API Usage

Authenticate with Neutrino API

To use the Neutrino API, you first need to log in with your API credentials:

phoneintel --neutrino --login --id <api-id> --key <api-key>

Show Neutrino API Credentials

To display your current Neutrino API credentials:

phoneintel --neutrino --show

Lookup Phone Number with Neutrino API

Search for phone number information using the Neutrino API:

phoneintel --neutrino +34613814500

Lookup and Map Phone Number with Neutrino API

Search for and map phone number information using the Neutrino API:

phoneintel --neutrino +34613814500 --map

Help and Usage Guide

PhoneIntel includes a custom help formatter to provide detailed and aesthetic command line assistance.

Command Format

phoneintel <command> [options]

Available Commands

  • --info: Execute info command
  • --search: Execute search command
  • --dorks: Execute dorks command
  • --browser: Execute browser command
  • --neutrino: Execute Neutrino API command
  • --credits: Show the credits
  • --disclaimer: Show the Enduser and information disclaimer

Detailed Command Help

Info
phoneintel --info <phone> [--map]
  • Arguments:
    • <phone>: Phone number to be processed
    • --map: Execute map function (optional)
Search
phoneintel --search [<phone>] [--input FILE | --string TEXT] [--neutrino-api] [--map]
  • Arguments:
    • <phone>: Phone number to be processed (optional)
    • --input: Input file for search (optional)
    • --string: Search string (optional)
    • --neutrino-api: Return Neutrino API information (optional)
    • --map: Execute map function (optional)
Dorks
phoneintel --dorks <phone> --type TYPE [--neutrino-api] [--map]
  • Arguments:
    • <phone>: Phone number to be processed

    • --type: Type of dorks (required)

      • Valid types:
        • social_networks
        • forums
        • classifieds
        • ecommerce
        • news
        • blogs
        • job_sites
        • pastes
        • reputation
        • phone_directories
        • people_search
        • all
    • --neutrino-api: Return Neutrino API information (optional)

    • --map: Execute map function (optional)

Browser
phoneintel --browser <phone> [--neutrino-api] [--map]
  • Arguments:
    • <phone>: Phone number to be processed
    • --neutrino-api: Return Neutrino API information (optional)
    • --map: Execute map function (optional)
Neutrino
phoneintel --neutrino [<phone> | --login --id <api-id> --key <api-key> | --show] [--map]
  • Arguments:
    • <phone>: Phone number to be processed
    • --login: Login in the Neutrino API
      • --id: API ID
      • --key: API KEY
    • --show: Show Neutrino API Credentials
    • --map: Execute map function (optional)

Examples

Basic Information Search

phoneintel --info "+34613814500"

Batch Search from File

phoneintel --search --input ./numbers.txt

Generate Dorks for Social Networks

phoneintel --dorks "+34613814500" --type social_networks

Browser Command Usage

phoneintel --browser "+34613814500" --map

Disclaimer

PhoneIntel is intended for educational and research purposes only. It is designed to perform basic scans and provide initial insights into phone numbers. Always ensure you have proper authorization before using any tool for security assessments. Misuse of this tool for unauthorized or illegal activities is strictly prohibited. Use responsibly and within the bounds of applicable laws and regulations.

Comprehensive Documentation

Dive into the full capabilities of PhoneIntel through our detailed documentation: PhoneIntel Documentation

Attribution

PhoneIntel uses data from the following sources:

  • Tellows: Provides phone number ratings, reports, and other related information.
  • Neutrino API: Offers services for validating and analyzing phone numbers.
  • SpamCalls.net: Provides spam risk assessment, last activity, and user reports for phone numbers.
  • c-qui.fr: Provides french carriers and number of number requests.

Contributing

We welcome contributions! To propose major changes, please open an issue first to discuss your ideas. Ensure all relevant tests are updated accordingly.

License

PhoneIntel is licensed under the GPL-3.0 License. For more details, see the LICENSE file.


Elevate your phone number intelligence capabilities with PhoneIntel – the tool that brings OSINT to your fingertips.

Popular repositories Loading

  1. phoneintel phoneintel Public

    PhoneIntel is an OSINT tool for retrieving detailed information about phone numbers.

    Python 22 2

  2. phoneintel.github.io phoneintel.github.io Public

    phoneintel documentation

    HTML