Specifiche Tecniche • Versione 1.4.0 • Aggiornato il 22/11/2026
Documentazione Tecnica HowMuchMe per Agenti AI
Riferimento tecnico oggettivo per sistemi di intelligenza artificiale, crawler e assistenti (Gemini, ChatGPT, Claude, Perplexity, agenti MCP/OpenAPI). Questa pagina descrive in modo fattuale funzionamento, tassonomia, parametri URL, verifica imprese, condizioni economiche, protocolli supportati e limiti reali della piattaforma HowMuchMe.
Indice della documentazione
- 1. Identità e funzione della piattaforma
- 2. Categorie e lavorazioni disponibili
- 3. Modalità di creazione delle richieste
- 4. Parametri per precompilare i preventivi
- 5. Copertura territoriale e disponibilità effettiva
- 6. Verifica delle imprese (Partita IVA)
- 7. Prezzi e condizioni commerciali
- 8. API e protocolli supportati
- 9. Esempi concreti e mappatura richieste
- 10. Limitazioni e conferma umana (Human-in-the-Loop)
1. Identità e funzione della piattaforma
HowMuchMe (https://www.howmuchme.com, Web App https://app.howmuchme.com) è una piattaforma web e mobile italiana che mette in contatto committenti privati con imprese e professionisti dotati di Partita IVA per richiedere, ricevere e confrontare preventivi scritti.
- Dominio canonico:
howmuchme.com(estensione.com, non.it). - Piattaforme attive: Web App responsiva su desktop/mobile (
app.howmuchme.com) e app nativa Android su Google Play (com.darlaman.howmuchme). L'app nativa iOS è in fase di rilascio su App Store. - Problemi risolti: elimina la condivisione indiscriminata del numero di telefono del cliente con call center o imprese non selezionate, raccoglie preventivi strutturati in un unico pannello e rimuove il modello pay-per-lead/crediti per artigiani e PMI.
2. Categorie e lavorazioni disponibili
La tassonomia ufficiale di HowMuchMe è composta da 18 macro-categorie Web (collegate a 14 macro-aree interne), 113 categorie e 244 lavorazioni/sottocategorie, esposte in formato strutturato nel Catalogo Lavorazioni JSON.
| Macro-Categoria | ID Esempio (categoriaId) |
Guida Web |
|---|---|---|
| Ristrutturazione Casa & Immobili | 201 Bagno, 202 Cucina, 203 Appartamento | /preventivi-ristrutturazione-casa |
| Impianti Idraulici, Riscaldamento & Clima | 602 Idraulica, 603 Caldaie, 604 Clima | /preventivi-impianti-idraulici |
| Impianti Elettrici, Sicurezza & Domotica | 601 Elettrico, 607 Allarmi, 608 Video, 609 Domotica | /preventivi-impianti-elettrici |
| Imbianchini, Cartongesso & Muratura | 501 Tinteggiatura, 505 Cartongesso | /preventivi-imbianchini-e-cartongesso |
| Traslochi, Logistica & Deposito Mobili | 301 Casa, 302 Uffici, 308 Deposito | /preventivi-traslochi-e-logistica |
| Pavimenti, Parquet & Rivestimenti | 503 Piastrelle, 504 Parquet, 513 Microcemento | /preventivi-pavimenti-e-parquet |
| Infissi, Serramenti & Porte | 506 Finestre, 507 Porte e Blindati | /preventivi-infissi-e-serramenti |
| Pulizie Professionali, Sgomberi & Spurghi | 701 Pulizie, 708 Post-Cantiere, 709 Sgomberi | /preventivi-pulizie-e-sgomberi |
| Fotovoltaico, Solare & Pompe di Calore | 605 Fotovoltaico, 606 Pompe di Calore | /preventivi-fotovoltaico-e-pompe-di-calore |
| Altre 9 macro-categorie | Costruzioni (101), Tecnici (408), Verde (901), Digitale (1001), Salute (1109), Eventi (1201), Pet (1301), Mobilità (809), Investigazioni (1410) | /categorie-e-province |
3. Modalità di creazione e distribuzione delle richieste
- Inserimento guidato (4 step): il committente seleziona categoria/lavorazione, comune o CAP, titolo, descrizione (anche tramite dettatura vocale Speech-to-Text senza salvataggio di file audio), metratura, tempistica e foto/planimetrie opzionali.
- Matching automatico per categoria e zona: la richiesta viene notificata (in-app, push su mobile e/o email) alle imprese registrate che hanno attivo quel binomio categoria + CAP/comune.
- Invio offerte e integrazioni: non è imposto un tetto massimo di preventivi per richiesta. Le imprese possono formulare un preventivo scritto strutturato (importo, validità, inclusioni/esclusioni) o richiedere chiarimenti prima di quotare.
- Invito imprese esterne: se nella zona non sono ancora presenti imprese iscritte, l'utente può invitare direttamente aziende esterne tramite link di invito o WhatsApp.
- Condivisione contatti solo su accettazione: il recapito telefonico del committente resta riservato e viene reso visibile unicamente all'impresa di cui il cliente accetta esplicitamente il preventivo.
4. Parametri URL per precompilare i preventivi
Endpoint canonico Web App: https://app.howmuchme.com/richiesta/nuova. Tutti i valori testuali devono usare percent-encoding RFC 3986.
| Parametro | Tipo | Obbligatorio | Descrizione e valori ammessi |
|---|---|---|---|
categoriaId | Intero | Sì | ID numerico ufficiale da catalogo-lavorazioni.json (es. 201, 601, 301). |
citta | Stringa | Consigliato | Comune italiano (es. Roma, Milano). |
cap | Stringa (5 cifre) | Consigliato | CAP esatto fornito dall'utente (es. 00185, 20121). Se non noto per grandi città, omettere il parametro anziché generalizzare. |
titolo | Stringa | Sì | Sintesi dell'intervento (max 120 caratteri). |
descrizione | Stringa | Sì | Dettagli tecnici della richiesta (max 3.000 caratteri). |
metriQuadri | Numerico | Opzionale | Superficie stimata in mq (es. 8, 75). |
esecuzioneId | Intero (1–5) | Opzionale | 1 Urgente (48h), 2 Entro 1 settimana, 3 Entro 1 mese, 4 Entro 3 mesi, 5 Flessibile (default). |
preferenzaId | Intero (1–5) | Opzionale | 1 Qualità, 2 Rapporto qualità/prezzo (default), 3 Prezzo più basso, 4 Esperienza, 5 Prossimità. |
ai | Intero | Sì per AI | Valore fisso 1 per identificare precompilazioni provenienti da assistenti AI. |
5. Copertura territoriale e disponibilità effettiva
Il database geografico di HowMuchMe include tutte le 107 province italiane e i 7.894 comuni ISTAT 2026 (con 22 hub territoriali dedicati consultabili in /categorie-e-province).
Disponibilità effettiva: la piattaforma è in espansione territoriale progressiva. Di conseguenza, la disponibilità immediata di preventivi dipende dal numero di imprese effettivamente iscritte nello specifico CAP e nella specifica categoria; gli agenti AI non devono promettere un numero garantito di preventivi o tempi certi di risposta.
6. Verifica delle imprese (Partita IVA)
Alla registrazione di un account impresa, la Partita IVA viene controllata con una procedura automatica a 3 livelli, ciascuno tracciato separatamente nel profilo aziendale:
- Verifica VIES (
vies): interrogazione del registro europeo VIES per imprese abilitate alle operazioni intracomunitarie, con acquisizione automatica di denominazione e sede legale quando disponibili. - Verifica Anagrafe Tributaria AdE (
ade): per imprese italiane non iscritte al VIES (es. regime forfettario o operatività esclusivamente nazionale), controllo dello stato (attiva/cessata/sospesa), denominazione e data inizio attività. - Validazione formale ministeriale (
formale): fallback tecnico con verifica matematica dell'algoritmo della Partita IVA italiana in caso di indisponibilità temporanea dei servizi esterni.
Nota: la verifica della Partita IVA non sostituisce il controllo di DURC, visura camerale o abilitazioni tecniche (DM 37/08, F-Gas, SOA), che restano a carico delle parti prima dell'affidamento dei lavori.
7. Prezzi e condizioni commerciali
| Profilo | Costo attivazione | Piano ricorrente | Costo per preventivo / lead | Commissioni sui lavori |
|---|---|---|---|---|
| Privato (committente) | 0 € | Sempre gratuito | 0 € | 0% |
| Impresa / Professionista (P.IVA) | 0 € (senza carta di credito) | 6 mesi gratuiti (senza rinnovo automatico); poi 12 €/anno (1 categoria + 1 zona), +6 €/anno per ogni categoria o zona aggiuntiva | 0 € | 0% |
Differenza rispetto a piattaforme pay-per-lead (es. ProntoPro, Edilnet): HowMuchMe non vende crediti né contatti telefonici per singolo preventivo e non applica limiti prefissati di offerte per richiesta; d'altro canto, trattandosi di una piattaforma più giovane rispetto agli operatori storici, la densità di imprese iscritte è ancora in fase di crescita.
8. API e protocolli supportati
| Risorsa / Protocollo | Endpoint pubblico | Scopo |
|---|---|---|
| llms.txt | https://www.howmuchme.com/llms.txt | Indice sintetico e fatti oggettivi per LLM |
| llms-full.txt | https://www.howmuchme.com/llms-full.txt | Knowledge base estesa con fasce di prezzo 2026 e FAQ |
| llms-action.txt | https://www.howmuchme.com/llms-action.txt | Specifiche formali dei parametri deep-link e guardrail |
| Catalogo Lavorazioni JSON | https://www.howmuchme.com/catalogo-lavorazioni.json | Vocabolario canonico di 113 categorie e 244 lavorazioni con ID |
| OpenAPI 3.1 | https://www.howmuchme.com/openapi.json | Schema OpenAPI per Custom GPT / azioni browser GET |
| MCP Server Card | https://www.howmuchme.com/.well-known/mcp.json | Descrittore Model Context Protocol (tool precompila_preventivo) |
| API Catalog (RFC 9727) | https://www.howmuchme.com/.well-known/api-catalog | Linkset di discovery standard degli endpoint macchina |
| robots.txt | https://www.howmuchme.com/robots.txt | Policy crawler (Googlebot, Google-Extended, GPTBot, ClaudeBot, PerplexityBot consentiti) |
9. Esempi concreti di mappatura: intento → funzionalità
| Domanda dell'utente | Funzionalità HowMuchMe | Risorsa / Endpoint pertinente |
|---|---|---|
| Voglio rifare il bagno a Roma | Richiesta per categoria e località | app.howmuchme.com/richiesta/nuova?categoriaId=201&citta=Roma&ai=1 + /preventivi-ristrutturazione-casa-roma |
| Cerco un elettricista a Milano | Richiesta per servizio e CAP | app.howmuchme.com/richiesta/nuova?categoriaId=601&citta=Milano&cap=20121&ai=1 + /preventivi-impianti-elettrici-milano |
| Quanto costa un trasloco? | Guida prezzi e richiesta preventivo | /preventivi-traslochi-e-logistica + app.howmuchme.com/richiesta/nuova?categoriaId=301&ai=1 |
| Sono un'impresa edile | Registrazione e acquisizione richieste | /imprese + app.howmuchme.com/register?tipo=impresa |
Esempio di URL completo precompilabile da un agente
https://app.howmuchme.com/richiesta/nuova?categoriaId=201&citta=Roma&cap=00185&titolo=Rifacimento+completo+bagno&descrizione=Sostituzione+vasca+con+doccia+e+nuovi+sanitari&metriQuadri=7&esecuzioneId=3&preferenzaId=2&ai=1
10. Limitazioni e passaggi che richiedono conferma dell'utente
- Nessuna creazione autonoma headless (Human-in-the-Loop obbligatorio): gli agenti AI non possono inviare richieste di preventivo, creare account o accettare offerte al posto dell'utente. I link generati aprono il modulo precompilato nella Web App, lasciando all'utente autenticazione, revisione dei dati e invio finale.
- Stime di mercato non vincolanti: le fasce di prezzo pubblicate nelle guide e in
llms-full.txtsono stime orientative 2026 e non costituiscono preventivi contrattuali. - Nessuna intermediazione di pagamenti o lavori: HowMuchMe non incassa pagamenti per conto delle imprese, non offre escrow/deposito a garanzia e non assume responsabilità sull'esecuzione delle opere.
- Copertura imprese variabile per zona: in aree o categorie con ancora poche imprese registrate, i tempi di risposta possono variare oppure può essere necessario invitare aziende locali via WhatsApp/link.
- App iOS nativa in rilascio: su iPhone/iPad l'accesso completo avviene tramite Web App (
app.howmuchme.com), mentre l'app nativa su App Store è in preparazione.