whoistel, a whois program for french telephone numbers

This is a work from 2013, written in Python 2.

The program uses the following information sources:

• Databases from ARCEP/INSEE, converted to SQLite format and then fetched locally
• Annu.com's API. Annu.com is Iliad's reverse telephone directory
• The ADSL eligibility test of OVH Telecom

Using whoistel

./whoistel.py <french telephone number> [--no-annu] [--no-ovh]

You need Python 2.7 to run this script.

ARCEP's databases

• Database that links geographic phone numbers to operators and city codes
• Database that links phone numbers ranges to operators
• Database that links city codes to city names (from INSEE)
• Database that links operator codes to operator names

Annu.com's API

http://v3.annu.com/cgi-bin/srch.cgi

GET parameters:

• j: 1 (removing this parameter sets the Content-Type header to text/html instead of text/plain)
• s: the phone number
• n: the maximum number of results
• i: 062C706C-A373-402E-B62A-89994449CD16 (this parameter apparently may be removed or modified without difference)
• lat/long: user's position? These parameters aren't mandatory and looks useless, that's maybe for Iliad's statistics

OVH's AJAX eligibility check

https://www.ovhtelecom.fr/cgi-bin/ajax/ajaxEligibilityCheck.cgi

GET parameters:

• number: the phone number
• lightRequest: yes if you want less informations
• fromIndexBar: yes if the content is loaded from ovhtelecom.fr's homepage. This parameter looks useless
• callback: a function name if you want to use JSONP, otherwise don't send this parameter

Useful Wikipedia pages

• Plan de numérotation téléphonique en France
• Numéros de téléphone français en 08
• Indicatif téléphonique local en France
• Liste des préfixes des opérateurs de téléphonie par internet en France
• Liste des préfixes des opérateurs de téléphonie mobile en France

Informations about surcharged calls

• ARCEP: Les numéros 08 et les numéros courts
• Orange: Le service téléphonique
• SFR: Tarifs et conditions générales d'inscription
• Free: Tarifs France métropolitaine mobiles et numéros spéciaux
• 118XYZ: Les principaux tarifs des services 118

TODO

• Use this database to show all cities composing a ZNE, not only the chief town
• Maybe add a backend for a website allowing to access the data of the G'NUM database
• Create a database about the surcharge of four-digits numbers
• Choose a language for the script and the README between French, English, or Frenglish
• Find a INSEE database that contains the name of cities with normal case
• Build packages for various distributions