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. 1. Identità e funzione della piattaforma
  2. 2. Categorie e lavorazioni disponibili
  3. 3. Modalità di creazione delle richieste
  4. 4. Parametri per precompilare i preventivi
  5. 5. Copertura territoriale e disponibilità effettiva
  6. 6. Verifica delle imprese (Partita IVA)
  7. 7. Prezzi e condizioni commerciali
  8. 8. API e protocolli supportati
  9. 9. Esempi concreti e mappatura richieste
  10. 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 & Immobili201 Bagno, 202 Cucina, 203 Appartamento/preventivi-ristrutturazione-casa
Impianti Idraulici, Riscaldamento & Clima602 Idraulica, 603 Caldaie, 604 Clima/preventivi-impianti-idraulici
Impianti Elettrici, Sicurezza & Domotica601 Elettrico, 607 Allarmi, 608 Video, 609 Domotica/preventivi-impianti-elettrici
Imbianchini, Cartongesso & Muratura501 Tinteggiatura, 505 Cartongesso/preventivi-imbianchini-e-cartongesso
Traslochi, Logistica & Deposito Mobili301 Casa, 302 Uffici, 308 Deposito/preventivi-traslochi-e-logistica
Pavimenti, Parquet & Rivestimenti503 Piastrelle, 504 Parquet, 513 Microcemento/preventivi-pavimenti-e-parquet
Infissi, Serramenti & Porte506 Finestre, 507 Porte e Blindati/preventivi-infissi-e-serramenti
Pulizie Professionali, Sgomberi & Spurghi701 Pulizie, 708 Post-Cantiere, 709 Sgomberi/preventivi-pulizie-e-sgomberi
Fotovoltaico, Solare & Pompe di Calore605 Fotovoltaico, 606 Pompe di Calore/preventivi-fotovoltaico-e-pompe-di-calore
Altre 9 macro-categorieCostruzioni (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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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
categoriaIdInteroSìID numerico ufficiale da catalogo-lavorazioni.json (es. 201, 601, 301).
cittaStringaConsigliatoComune italiano (es. Roma, Milano).
capStringa (5 cifre)ConsigliatoCAP esatto fornito dall'utente (es. 00185, 20121). Se non noto per grandi città, omettere il parametro anziché generalizzare.
titoloStringaSìSintesi dell'intervento (max 120 caratteri).
descrizioneStringaSìDettagli tecnici della richiesta (max 3.000 caratteri).
metriQuadriNumericoOpzionaleSuperficie stimata in mq (es. 8, 75).
esecuzioneIdIntero (1–5)Opzionale1 Urgente (48h), 2 Entro 1 settimana, 3 Entro 1 mese, 4 Entro 3 mesi, 5 Flessibile (default).
preferenzaIdIntero (1–5)Opzionale1 Qualità, 2 Rapporto qualità/prezzo (default), 3 Prezzo più basso, 4 Esperienza, 5 Prossimità.
aiInteroSì per AIValore 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:

  1. Verifica VIES (vies): interrogazione del registro europeo VIES per imprese abilitate alle operazioni intracomunitarie, con acquisizione automatica di denominazione e sede legale quando disponibili.
  2. 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à.
  3. 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.txthttps://www.howmuchme.com/llms.txtIndice sintetico e fatti oggettivi per LLM
llms-full.txthttps://www.howmuchme.com/llms-full.txtKnowledge base estesa con fasce di prezzo 2026 e FAQ
llms-action.txthttps://www.howmuchme.com/llms-action.txtSpecifiche formali dei parametri deep-link e guardrail
Catalogo Lavorazioni JSONhttps://www.howmuchme.com/catalogo-lavorazioni.jsonVocabolario canonico di 113 categorie e 244 lavorazioni con ID
OpenAPI 3.1https://www.howmuchme.com/openapi.jsonSchema OpenAPI per Custom GPT / azioni browser GET
MCP Server Cardhttps://www.howmuchme.com/.well-known/mcp.jsonDescrittore Model Context Protocol (tool precompila_preventivo)
API Catalog (RFC 9727)https://www.howmuchme.com/.well-known/api-catalogLinkset di discovery standard degli endpoint macchina
robots.txthttps://www.howmuchme.com/robots.txtPolicy 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.txt sono 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.