Ferret Python SDK

Client Python pour Ferret — open source web data API client

Installation

pip install ferret-client

Ou directement depuis le repo :

pip install git+https://github.com/duan78/ferret.git

Usage

from ferret_client import FerretClient

client = FerretClient("http://localhost:9093")

# Recherche web multi-moteur
results = client.search("AI developments 2026")
for r in results["items"]:
    print(f"[{r.get('source', '?')}] {r['title']}")

# Deep research (5 moteurs en parallèle + résumé)
report = client.research("AI 2026")
print(report["answer"])

# Extraction de contenu
content = client.extract("https://example.com")

# Données françaises (44 APIs)
dvf = client.dvf("75001")         # Prix immobilier Paris 1er
sirene = client.sirene("Decathlon")  # Recherche entreprises
rna = client.rna("Restos du Cœur")   # Associations

# APIs internationales
uk_data = client.uk_data("population")
eurostat = client.eurostat_gdp("FR")
bbc = client.bbc_news("technology")
who = client.who_health()

# Utilitaires
ip = client.ip()
geo = client.geolocate("8.8.8.8")

Configuration

# URL par défaut : http://localhost:9093
client = FerretClient("http://192.168.0.37:9093")  # Remote server
client = FerretClient("https://api.ferret.guru")    # Production