MCPcopy Index your code
hub / github.com/sundowndev/phoneinfoga

github.com/sundowndev/phoneinfoga @v2.11.0 sqlite

repository ↗ · DeepWiki ↗ · release v2.11.0 ↗
272 symbols 1,030 edges 80 files 46 documented · 17% 37 cross-repo links
README

project logo

build status go report code climate badge Coverage Status Latest version Docker pulls

Information gathering framework for phone numbers

DocumentationAPI documentationRelated blog post

About

PhoneInfoga is one of the most advanced tools to scan international phone numbers. It allows you to first gather basic information such as country, area, carrier and line type, then use various techniques to try to find the VoIP provider or identify the owner. It works with a collection of scanners that must be configured in order for the tool to be effective. PhoneInfoga doesn't automate everything, it's just there to help investigating on phone numbers.

Current status

This project is stable and production-ready.

Demo instance termination

The demo instance has been terminated on December 21th, 2023. It's been expensive to maintain this instance throughout the years given the number of requests it received (~20K/month), without bringing much value to users compared to using it locally. Use it locally with your own API keys for a better experience.

Features

  • Check if phone number exists
  • Gather basic information such as country, line type and carrier
  • OSINT footprinting using external APIs, phone books & search engines
  • Check for reputation reports, social media, disposable numbers and more
  • Use the graphical user interface to run scans from the browser
  • Programmatic usage with the REST API and Go modules

Anti-features

  • Does not claim to provide relevant or verified data, it's just a tool !
  • Does not allow to "track" a phone or its owner in real time
  • Does not allow to get the precise phone location
  • Does not allow to hack a phone

License

FOSSA Status

This tool is licensed under the GNU General Public License v3.0.

Icon made by Freepik from flaticon.com is licensed by CC 3.0 BY.

Support

Support me by signing up to DigitalOcean using my link ($200 free credits)

DigitalOcean Referral Badge

Extension points exported contracts — how you extend this code

Scanner (Interface)
(no doc) [7 implementers]
lib/remote/scanner.go
Output (Interface)
(no doc) [1 implementers]
lib/output/output.go
Filter (Interface)
(no doc) [1 implementers]
lib/filter/filter.go
Element (Interface)
(no doc)
web/client/src/shims-tsx.d.ts
HandlerFunc (FuncType)
(no doc)
web/v2/api/response.go
OVHSupplierInterface (Interface)
(no doc) [2 implementers]
lib/remote/suppliers/ovh.go
ElementClass (Interface)
(no doc)
web/client/src/shims-tsx.d.ts
NumverifySupplierInterface (Interface)
(no doc) [2 implementers]
lib/remote/suppliers/numverify.go

Core symbols most depended-on inside this repo

Run
called by 61
lib/remote/scanner.go
NewNumber
called by 27
lib/number/number.go
AddScanner
called by 24
lib/remote/remote.go
NewEngine
called by 20
lib/filter/filter.go
Name
called by 18
lib/remote/scanner.go
NewLibrary
called by 18
lib/remote/remote.go
NewFakeUSNumber
called by 17
test/number.go
String
called by 16
web/errors/errors.go

Shape

Function 120
Method 75
Struct 61
Interface 13
TypeAlias 2
FuncType 1

Languages

Go95%
TypeScript5%

Modules by API surface

lib/remote/suppliers/numverify.go13 symbols
lib/remote/googlesearch_scanner.go13 symbols
lib/remote/googlecse_scanner.go11 symbols
web/controllers.go10 symbols
lib/remote/scanner.go10 symbols
lib/remote/remote.go10 symbols
web/v2/api/handlers/scanners.go9 symbols
lib/remote/ovh_scanner.go9 symbols
lib/remote/suppliers/ovh.go8 symbols
lib/remote/remote_test.go8 symbols
lib/remote/numverify_scanner.go7 symbols
lib/remote/local_scanner.go7 symbols

Dependencies from manifests, versioned

cloud.google.com/go/computev1.7.0 · 1×
github.com/KyleBanks/depthv1.2.1 · 1×
github.com/PuerkitoBio/purellv1.1.1 · 1×
github.com/PuerkitoBio/urlescv0.0.0-2017081014372 · 1×
github.com/chenzhuoyu/base64xv0.0.0-2022111506244 · 1×
github.com/gin-contrib/ssev0.1.0 · 1×
github.com/go-openapi/jsonpointerv0.19.5 · 1×

For agents

$ claude mcp add phoneinfoga \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact