# PhoneIntel - Transforming Phone Number Intelligence
[](https://pypi.org/project/phoneintel/)
[](https://GitHub.com/phoneintel/phoneintel/issues/)
[](https://GitHub.com/phoneintel/phoneintel/pull/)
[](https://github.com/phoneintel/phoneintel/network/)
[](https://github.com/phoneintel/phoneintel/blob/main/LICENSE)
[](https://GitHub.com/phoneintel/phoneintel/graphs/contributors/)
[](https://GitHub.com/phoneintel/phoneintel/stargazers/)
[](https://www.python.org/)
### 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](https://www.tellows.com), including URL, score, and call type.
- **SpamCalls Integration**: Extract spam risk, last activity, and the latest report of phone numbers from [SpamCalls.net](https://spamcalls.net).
- **Neutrino API Integration**: Authenticate, search, and map phone number information using the [Neutrino API](https://www.neutrinoapi.com).
### Installation
1. Run the following command.
```bash
pip install phoneintel
```
### For Kali Linux Users
Remember to add the Directory to PATH:
```bash
export PATH=$PATH:/home/<username>/.local/bin
```
### Getting Started
#### Single Phone Number Lookup
Discover detailed information about a specific phone number:
```bash
phoneintel --info +34613814500
```
#### Multiple Phone Numbers from a String
Analyze multiple phone numbers embedded within a text string:
```bash
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:
```bash
phoneintel --search --input ./example.txt
```
#### OpenStreetMap Location Mapping
View the location of a phone number on OpenStreetMap:
```bash
phoneintel --info "+34613814500" --map
```
#### Generate Google Dorks
Create targeted Google dorks for various categories:
```bash
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:
```bash
phoneintel --neutrino --login --id <api-id> --key <api-key>
```
#### Show Neutrino API Credentials
To display your current Neutrino API credentials:
```bash
phoneintel --neutrino --show
```
#### Lookup Phone Number with Neutrino API
Search for phone number information using the Neutrino API:
```bash
phoneintel --neutrino +34613814500
```
#### Lookup and Map Phone Number with Neutrino API
Search for and map phone number information using the Neutrino API:
```bash
phoneintel --neutrino +34613814500 --map
```
### Help and Usage Guide
PhoneIntel includes a custom help formatter to provide detailed and aesthetic command line assistance.
#### Command Format
```bash
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
```bash
phoneintel --info <phone> [--map]
```
- **Arguments:**
- `<phone>`: Phone number to be processed
- `--map`: Execute map function (optional)
##### Search
```bash
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
```bash
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
```bash
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
```bash
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
```bash
phoneintel --info "+34613814500"
```
#### Batch Search from File
```bash
phoneintel --search --input ./numbers.txt
```
#### Generate Dorks for Social Networks
```bash
phoneintel --dorks "+34613814500" --type social_networks
```
#### Browser Command Usage
```bash
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](https://phoneintel.github.io)
### Attribution
PhoneIntel uses data from the following sources:
- [Tellows](https://www.tellows.com): Provides phone number ratings, reports, and other related information.
- [Neutrino API](https://www.neutrinoapi.com): Offers services for validating and analyzing phone numbers.
- [SpamCalls.net](https://spamcalls.net): Provides spam risk assessment, last activity, and user reports for phone numbers.
### 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 Apache 2.0 License. For more details, see the [LICENSE](https://github.com/phoneintel/phoneintel/blob/main/LICENSE) file.
---
Elevate your phone number intelligence capabilities with PhoneIntel – the tool that brings OSINT to your fingertips.
Raw data
{
"_id": null,
"home_page": "https://github.com/phoneintel/phoneintel",
"name": "phoneintel",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "PhoneIntel",
"author_email": "phoneintel@proton.me",
"download_url": "https://files.pythonhosted.org/packages/b8/50/0576dfbef312fc93decd4e43d546fd4146393b308beb3f92de033da5d70d/phoneintel-1.1.0.tar.gz",
"platform": null,
"description": "\r\n# PhoneIntel - Transforming Phone Number Intelligence\r\n\r\n[](https://pypi.org/project/phoneintel/)\r\n[](https://GitHub.com/phoneintel/phoneintel/issues/)\r\n[](https://GitHub.com/phoneintel/phoneintel/pull/)\r\n[](https://github.com/phoneintel/phoneintel/network/)\r\n[](https://github.com/phoneintel/phoneintel/blob/main/LICENSE)\r\n[](https://GitHub.com/phoneintel/phoneintel/graphs/contributors/)\r\n[](https://GitHub.com/phoneintel/phoneintel/stargazers/)\r\n[](https://www.python.org/)\r\n\r\n### Introduction\r\n\r\nWelcome 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.\r\n\r\nWith 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.\r\n\r\n### Key Features\r\n\r\n- **In-Depth Phone Number Analysis**: Gain detailed insights such as country, area or state, and carrier information.\r\n- **Batch Processing**: Effortlessly analyze multiple phone numbers from a text file.\r\n- **Google Dork Generation**: Create URL-encoded Google dorks tailored to specific categories.\r\n- **Location Mapping**: Visualize phone number locations on OpenStreetMap with the `--map` option.\r\n- **Tellows Integration**: Access additional data from [Tellows](https://www.tellows.com), including URL, score, and call type.\r\n- **SpamCalls Integration**: Extract spam risk, last activity, and the latest report of phone numbers from [SpamCalls.net](https://spamcalls.net).\r\n- **Neutrino API Integration**: Authenticate, search, and map phone number information using the [Neutrino API](https://www.neutrinoapi.com).\r\n\r\n### Installation\r\n\r\n1. Run the following command.\r\n\r\n ```bash\r\n pip install phoneintel\r\n ```\r\n\r\n### For Kali Linux Users\r\n\r\nRemember to add the Directory to PATH:\r\n\r\n```bash\r\nexport PATH=$PATH:/home/<username>/.local/bin\r\n```\r\n\r\n### Getting Started\r\n\r\n#### Single Phone Number Lookup\r\nDiscover detailed information about a specific phone number:\r\n```bash\r\nphoneintel --info +34613814500\r\n```\r\n\r\n#### Multiple Phone Numbers from a String\r\nAnalyze multiple phone numbers embedded within a text string:\r\n```bash\r\nphoneintel --search --string \"My number is +16148077641 but you can call me at +34613814500\"\r\n```\r\n\r\n#### Batch Analysis from a Text File\r\nProcess multiple phone numbers listed in a text file:\r\n```bash\r\nphoneintel --search --input ./example.txt\r\n```\r\n\r\n#### OpenStreetMap Location Mapping\r\nView the location of a phone number on OpenStreetMap:\r\n```bash\r\nphoneintel --info \"+34613814500\" --map\r\n```\r\n\r\n#### Generate Google Dorks\r\nCreate targeted Google dorks for various categories:\r\n```bash\r\nphoneintel \"+34613814500\" --dorks --type social_networks\r\n```\r\n\r\n### Neutrino API Usage\r\n\r\n#### Authenticate with Neutrino API\r\nTo use the Neutrino API, you first need to log in with your API credentials:\r\n```bash\r\nphoneintel --neutrino --login --id <api-id> --key <api-key>\r\n```\r\n\r\n#### Show Neutrino API Credentials\r\nTo display your current Neutrino API credentials:\r\n```bash\r\nphoneintel --neutrino --show\r\n```\r\n\r\n#### Lookup Phone Number with Neutrino API\r\nSearch for phone number information using the Neutrino API:\r\n```bash\r\nphoneintel --neutrino +34613814500\r\n```\r\n\r\n#### Lookup and Map Phone Number with Neutrino API\r\nSearch for and map phone number information using the Neutrino API:\r\n```bash\r\nphoneintel --neutrino +34613814500 --map\r\n```\r\n\r\n### Help and Usage Guide\r\n\r\nPhoneIntel includes a custom help formatter to provide detailed and aesthetic command line assistance.\r\n\r\n#### Command Format\r\n```bash\r\nphoneintel <command> [options]\r\n```\r\n\r\n#### Available Commands\r\n\r\n- `--info`: Execute info command\r\n- `--search`: Execute search command\r\n- `--dorks`: Execute dorks command\r\n- `--browser`: Execute browser command\r\n- `--neutrino`: Execute Neutrino API command\r\n- `--credits`: Show the credits\r\n- `--disclaimer`: Show the Enduser and information disclaimer\r\n\r\n#### Detailed Command Help\r\n\r\n##### Info\r\n```bash\r\nphoneintel --info <phone> [--map]\r\n```\r\n- **Arguments:**\r\n - `<phone>`: Phone number to be processed\r\n - `--map`: Execute map function (optional)\r\n\r\n##### Search\r\n```bash\r\nphoneintel --search [<phone>] [--input FILE | --string TEXT] [--neutrino-api] [--map]\r\n```\r\n- **Arguments:**\r\n - `<phone>`: Phone number to be processed (optional)\r\n - `--input`: Input file for search (optional)\r\n - `--string`: Search string (optional)\r\n - `--neutrino-api`: Return Neutrino API information (optional)\r\n - `--map`: Execute map function (optional)\r\n\r\n##### Dorks\r\n```bash\r\nphoneintel --dorks <phone> --type TYPE [--neutrino-api] [--map]\r\n```\r\n- **Arguments:**\r\n - `<phone>`: Phone number to be processed\r\n - `--type`: Type of dorks (required)\r\n - Valid types: \r\n - social_networks \r\n - forums\r\n - classifieds \r\n - ecommerce\r\n - news \r\n - blogs \r\n - job_sites \r\n - pastes \r\n - reputation \r\n - phone_directories\r\n - people_search\r\n - all\r\n \r\n - `--neutrino-api`: Return Neutrino API information (optional)\r\n - `--map`: Execute map function (optional)\r\n\r\n##### Browser\r\n```bash\r\nphoneintel --browser <phone> [--neutrino-api] [--map]\r\n```\r\n- **Arguments:**\r\n - `<phone>`: Phone number to be processed\r\n - `--neutrino-api`: Return Neutrino API information (optional)\r\n - `--map`: Execute map function (optional)\r\n\r\n##### Neutrino\r\n```bash\r\nphoneintel --neutrino [<phone> | --login --id <api-id> --key <api-key> | --show] [--map]\r\n```\r\n- **Arguments:**\r\n - `<phone>`: Phone number to be processed\r\n - `--login`: Login in the Neutrino API\r\n - `--id`: API ID\r\n - `--key`: API KEY\r\n - `--show`: Show Neutrino API Credentials\r\n - `--map`: Execute map function (optional)\r\n\r\n### Examples\r\n\r\n#### Basic Information Search\r\n```bash\r\nphoneintel --info \"+34613814500\"\r\n```\r\n\r\n#### Batch Search from File\r\n```bash\r\nphoneintel --search --input ./numbers.txt\r\n```\r\n\r\n#### Generate Dorks for Social Networks\r\n```bash\r\nphoneintel --dorks \"+34613814500\" --type social_networks\r\n```\r\n\r\n#### Browser Command Usage\r\n```bash\r\nphoneintel --browser \"+34613814500\" --map\r\n```\r\n\r\n### Disclaimer\r\n\r\nPhoneIntel 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.\r\n\r\n### Comprehensive Documentation\r\n\r\nDive into the full capabilities of PhoneIntel through our detailed documentation: [PhoneIntel Documentation](https://phoneintel.github.io)\r\n\r\n### Attribution\r\n\r\nPhoneIntel uses data from the following sources:\r\n\r\n- [Tellows](https://www.tellows.com): Provides phone number ratings, reports, and other related information.\r\n- [Neutrino API](https://www.neutrinoapi.com): Offers services for validating and analyzing phone numbers.\r\n- [SpamCalls.net](https://spamcalls.net): Provides spam risk assessment, last activity, and user reports for phone numbers.\r\n\r\n### Contributing\r\n\r\nWe welcome contributions! To propose major changes, please open an issue first to discuss your ideas. Ensure all relevant tests are updated accordingly.\r\n\r\n### License\r\n\r\nPhoneIntel is licensed under the Apache 2.0 License. For more details, see the [LICENSE](https://github.com/phoneintel/phoneintel/blob/main/LICENSE) file.\r\n\r\n---\r\n\r\nElevate your phone number intelligence capabilities with PhoneIntel \u00e2\u20ac\u201c the tool that brings OSINT to your fingertips.\r\n\r\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "A tool for processing phone numbers with OSINT capabilities.",
"version": "1.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/phoneintel/phoneintel/issues",
"Documentation": "https://phoneintel.github.io/",
"Homepage": "https://github.com/phoneintel/phoneintel",
"Source Code": "https://github.com/phoneintel/phoneintel"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c8b47e7937a09365b0f744c1718be798f23ebf19809b5091471be296445dcea2",
"md5": "0f513f022e053e841fd8bee4f4ae7046",
"sha256": "200d3661eaa8f1e5934238c19e909c90341ada641fed3bd92de6348a54c451e1"
},
"downloads": -1,
"filename": "phoneintel-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0f513f022e053e841fd8bee4f4ae7046",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 222665,
"upload_time": "2024-08-13T01:42:07",
"upload_time_iso_8601": "2024-08-13T01:42:07.673692Z",
"url": "https://files.pythonhosted.org/packages/c8/b4/7e7937a09365b0f744c1718be798f23ebf19809b5091471be296445dcea2/phoneintel-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b8500576dfbef312fc93decd4e43d546fd4146393b308beb3f92de033da5d70d",
"md5": "848852ee13d185b3591aad28fcf9f869",
"sha256": "cafb9068e7b19038814d1cf061a3185c2c36f522733df902c7f3b346d9ca0f21"
},
"downloads": -1,
"filename": "phoneintel-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "848852ee13d185b3591aad28fcf9f869",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 213769,
"upload_time": "2024-08-13T01:42:09",
"upload_time_iso_8601": "2024-08-13T01:42:09.411458Z",
"url": "https://files.pythonhosted.org/packages/b8/50/0576dfbef312fc93decd4e43d546fd4146393b308beb3f92de033da5d70d/phoneintel-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-13 01:42:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "phoneintel",
"github_project": "phoneintel",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "phoneintel"
}
JSON
