Ultimo aggiornamento · revisionato dalla redazione di Essentras
Ricetta per agenti
“Gestisco un piccolo studio legale in Texas e voglio essere citato nelle notizie locali e in una rivista economica regionale entro 30 giorni.”
L'agente cerca il Texas per nome, trova testate di Dallas con q perché le inserzioni non riportano la città, e prepara il preventivo dell'unica edizione texana della rivista economica più una testata di Dallas a $9,167. Precisa che un articolo a pagamento non è una citazione di un giornalista e non promette alcuna data.
Risposte acquisite il 19 ott 2026. I prezzi cambiano, quindi l'agente deve richiedere un nuovo preventivo prima di mostrare un totale.
search_outletsget_outletquote_placementsCollega prima il server MCP o l'API REST: nessun account, nessuna chiave. Regole: briefing per agenti.
I passaggi
Cerca lo Stato per nome
L'acquirente ha indicato uno Stato, una professione e una scadenza, ma nessun budget. Quando queste risposte sono state registrate, state confrontava la regione solo così come la scrive ogni inserzione, quindi il codice di 2 lettere non restituiva nulla e l'agente ha inviato il nome. Ora l'API accetta anche la sigla postale; il nome funziona sempre. Ordinate per prezzo, tornano 31 inserzioni del Texas.
Chiamata allo strumento MCP: search_outlets{ "country": "US", "state": "TX" }La stessa chiamata via RESTcurl "https://essentras.com/api/agent/v1/outlets?\ country=US&state=TX"Risposta reale, abbreviata. Acquisita il 19 ott 2026{ "total": 0, "results": [] }Cosa leggere: total era 0 al momento della registrazione: state accettava solo il nome. Ora la sigla postale funziona.
Chiamata allo strumento MCP: search_outlets{ "country": "US", "state": "Texas", "sort": "price_asc", "limit": 100 }La stessa chiamata via RESTcurl "https://essentras.com/api/agent/v1/outlets?\ country=US&state=Texas&sort=price_asc&limit=100"Risposta reale, abbreviata. Acquisita il 19 ott 2026{ "total": 31, "has_more": false, "results": [ { "id": "texas-today", "outlet": {"name": "Texas Today", "city": null}, "price": {"amount": 260}, "delivery": {"turnaround_window": "3-5 business days"}, "link": {"sponsored_tag": "DISCRETE"} }, { "id": "the-texas-developer", "outlet": {"name": "The Texas Developer", "city": null}, "price": {"amount": 417}, "delivery": {"turnaround_window": "3 business days"}, "link": {"sponsored_tag": "NO"} }, { "id": "dallas-herald", "outlet": {"name": "Dallas Herald", "city": null}, "price": {"amount": 583}, "delivery": {"turnaround_window": "3 business days"}, "link": {"sponsored_tag": "NO"} }, { "id": "dallas-observer-6-month-lifespan", "outlet": {"name": "Dallas Observer; 6 Month Lifespan", "city": null}, "price": {"amount": 1667}, "delivery": {"turnaround_window": "3 business days"}, "link": {"sponsored_tag": "YES"} }, { "id": "fort-bend-star", "outlet": {"name": "Fort Bend Star", "city": null}, "price": {"amount": 1833}, "delivery": {"turnaround_window": "3-5 business days"}, "link": {"sponsored_tag": "NO"} }, { "id": "the-leader-news", "outlet": {"name": "The Leader News", "city": null}, "price": {"amount": 1833}, "delivery": {"turnaround_window": "3-5 business days"}, "link": {"sponsored_tag": "NO"} } ] }Cosa leggere: Mostrati 6 risultati su 31. outlet.city è null in ogni inserzione del Texas, quindi al momento della registrazione un filtro per città non ne trovava nessuna (ora city corrisponde anche ai nomi delle testate), e delivery.turnaround_window è di 2 settimane o meno in tutte e 31.
Chiedi la città, poi cerca il suo nome
L'agente chiede dove ha sede lo studio; qui, Dallas. Poiché le inserzioni non riportano la città, cerca il nome della città con q, che corrisponde al nome dell'inserzione. Dopo questa registrazione, city= corrisponde anche ai nomi delle testate.
Chiamata allo strumento MCP: search_outlets{ "q": "Dallas" }La stessa chiamata via RESTcurl "https://essentras.com/api/agent/v1/outlets?\ q=Dallas"Risposta reale, abbreviata. Acquisita il 19 ott 2026{ "total": 4, "has_more": false, "results": [ { "id": "dallas-herald", "outlet": {"name": "Dallas Herald", "state_or_region": "Texas", "domain_authority": 5}, "price": {"amount": 583}, "delivery": {"turnaround_window": "3 business days"}, "link": {"sponsored_tag": "NO"} }, { "id": "dallas-culturemap-com", "outlet": { "name": "CultureMap Dallas", "state_or_region": null, "domain_authority": 80 }, "price": {"amount": 11467}, "delivery": {"turnaround_window": "2-4 weeks"}, "link": {"sponsored_tag": "YES"} }, { "id": "bizjournals-com-dallas", "outlet": { "name": "BizJournals.com (Dallas)", "state_or_region": "Texas", "domain_authority": 92 }, "price": {"amount": 7500}, "delivery": {"turnaround_window": "1-2 weeks"}, "link": {"sponsored_tag": "DISCRETE"} }, { "id": "dallas-observer-6-month-lifespan", "outlet": { "name": "Dallas Observer; 6 Month Lifespan", "state_or_region": "Texas; United States", "domain_authority": 78 }, "price": {"amount": 1667}, "delivery": {"turnaround_window": "3 business days"}, "link": {"sponsored_tag": "YES"} } ] }Cosa leggere: CultureMap Dallas non ha state_or_region, quindi la ricerca per Texas lo ha mancato, e la sua finestra dichiarata è di 2-4 settimane: più lunga delle 2 settimane che l'agente ammette per una scadenza di 30 giorni. Dallas Observer; 6 Month Lifespan è l'inserzione di Dallas con la Domain Authority più alta che rientra nei criteri.
Trova la rivista economica regionale
La rivista economica si vende per edizione. q BizJournals restituisce 11 edizioni con has_more false, e 1 è in Texas. Una ricerca di Business Journal con state Texas restituisce 0.
Chiamata allo strumento MCP: search_outlets{ "q": "BizJournals" }La stessa chiamata via RESTcurl "https://essentras.com/api/agent/v1/outlets?\ q=BizJournals"Risposta reale, abbreviata. Acquisita il 19 ott 2026{ "total": 11, "has_more": false, "results": [ { "id": "bizjournals-com", "outlet": {"state_or_region": null}, "price": {"amount": 7500} }, { "id": "bizjournals-com-atlanta", "outlet": {"state_or_region": null}, "price": {"amount": 7500} }, { "id": "bizjournals-com-seattle", "outlet": {"state_or_region": null}, "price": {"amount": 7500} }, { "id": "bizjournals-com-los-angeles", "outlet": {"state_or_region": "Los Angeles"}, "price": {"amount": 7500} }, { "id": "bizjournals-com-silicon-valley", "outlet": {"state_or_region": null}, "price": {"amount": 7500} }, { "id": "bizjournals-com-dallas", "outlet": {"state_or_region": "Texas"}, "price": {"amount": 7500} }, { "id": "bizjournals-com-new-york", "outlet": {"state_or_region": "New York"}, "price": {"amount": 7500} }, { "id": "bizjournals-com-chicago", "outlet": {"state_or_region": "Illinois"}, "price": {"amount": 7500} }, { "id": "bizjournals-com-washington-dc", "outlet": {"state_or_region": null}, "price": {"amount": 7500} }, { "id": "bizjournals-com-honolulu", "outlet": {"state_or_region": null}, "price": {"amount": 7500} }, { "id": "bizjournals-com-miami", "outlet": {"state_or_region": "Florida"}, "price": {"amount": 7500} } ] }Cosa leggere: Ogni edizione costa $7,500 con un'indicazione discreta. Quella del Texas è BizJournals.com (Dallas), che la ricerca per Texas aveva già trovato.
Leggi per intero i termini della rivista
get_outlet restituisce l'intera inserzione: la finestra dichiarata, come vengono conteggiati i tempi di consegna, il link e l'etichetta.
Chiamata allo strumento MCP: get_outlet{ "id": "bizjournals-com-dallas" }La stessa chiamata via RESTcurl https://essentras.com/api/agent/v1/outlets/bizjournals-com-dallasRisposta reale, abbreviata. Acquisita il 19 ott 2026{ "id": "bizjournals-com-dallas", "outlet": { "name": "BizJournals.com (Dallas)", "state_or_region": "Texas", "genres": ["News", "Business"], "domain_authority": 92, "domain_rating": 91 }, "price": {"amount": 7500}, "delivery": { "turnaround_window": "1-2 weeks", "refund_policy": "Refunded if not published, or if the turnaround is missed.", "turnaround_basis": "business days, paused while we are waiting on you, plus a 3 business day grace period" }, "link": { "dofollow": false, "indexed": "YES", "sponsored_tag": "DISCRETE", "disclosure": "Published with a discreet disclosure." }, "includes": { "writing_available": true, "draft_review": true, "screenshot_proof": true, "live_link": true } }Cosa leggere: turnaround_window è “1-2 weeks”, conteggiato in giorni lavorativi, sospeso mentre Essentras attende l'acquirente, più 3 giorni lavorativi di tolleranza. link.disclosure: “Published with a discreet disclosure.”
Preventivo per la rivista e 1 testata locale
L'agente dichiara la sua regola di scelta: l'edizione texana della rivista economica, più l'inserzione di Dallas con la Domain Authority più alta la cui finestra dichiarata è di 2 settimane o meno. Prepara il preventivo solo di ciò che l'acquirente approva.
Chiamata allo strumento MCP: quote_placements{ "items": [{"id": "bizjournals-com-dallas"}, {"id": "dallas-observer-6-month-lifespan"}] }La stessa chiamata via RESTcurl -X POST https://essentras.com/api/agent/v1/quote \ -H 'Content-Type: application/json' \ -d '{"items":[{"id":"bizjournals-com-dallas"},{"id":"dallas-observer-6-month-lifespan"}]}'Risposta reale, abbreviata. Acquisita il 19 ott 2026{ "line_items": [ { "id": "bizjournals-com-dallas", "name": "BizJournals.com (Dallas)", "unit_price": 7500, "turnaround": "1-2 Weeks" }, { "id": "dallas-observer-6-month-lifespan", "name": "Dallas Observer; 6 Month Lifespan", "unit_price": 1667, "turnaround": "3 Days" } ], "unavailable": [], "subtotal": 9167, "discount": { "amount": 0, "percent": 0, "next_tier": "Add 1 more placement(s) for 10% off the whole basket." }, "total": 9167, "billing_trigger": "on_order", "checkout_url": "https://essentras.com/cart?add=bizjournals-com-dallas%2Cdallas-observer-6-month-lifespan&utm_source=ai_agent&utm_medium=agent_api", "expires_in_seconds": 86400 }Cosa leggere: total è $9,167. discount.next_tier offre il 10% di sconto sull'intero carrello con 1 pubblicazione in più: è un'opzione, mai aggiunta senza richiesta.
Le inserzioni di Dallas, come le ha restituite l'API
| Inserzione | Prezzo | Finestra dichiarata | Domain Authority | Etichetta, come indicata nella scheda | Nel preventivo |
|---|---|---|---|---|---|
| Dallas Herald | $583 | 3 giorni lavorativi | 5 | Nessuna indicazione di sponsorizzato | No: Domain Authority più bassa |
| CultureMap Dallas | $11,467 | 2-4 settimane | 80 | Etichetta di sponsor o partner | No: finestra oltre le 2 settimane |
| BizJournals.com (Dallas) | $7,500 | 1-2 settimane | 92 | Indicazione discreta | Sì |
| Dallas Observer; 6 Month Lifespan | $1,667 | 3 giorni lavorativi | 78 | Etichetta di sponsor o partner | Sì |
Cosa dice l'agente all'acquirente
Un giornalista che sceglie di citarti non si compra, e non farò passare un articolo a pagamento per questo. Quello che posso acquistare per te sono pubblicazioni a pagamento: articoli sul tuo studio su testate del Texas, a pagamento qualunque etichetta aggiunga ciascuna testata.
Per uno studio legale, un articolo a pagamento può essere considerato pubblicità secondo le regole del tuo ordine, quindi verificale prima di acquistare. Non do consulenza legale.
In Texas l'API vende 31 inserzioni, da $260 (Texas Today). L'unica edizione texana della rivista economica è BizJournals.com (Dallas), $7,500, con un'indicazione discreta e una finestra dichiarata di 1-2 settimane.
Per uno studio a Dallas aggiungerei Dallas Observer; 6 Month Lifespan, $1,667, l'inserzione di Dallas con la Domain Authority più alta che dichiara 2 settimane o meno. Il nome dell'inserzione indica una durata di 6 mesi, quindi chiedi se l'articolo viene rimosso dopo 6 mesi. Insieme il preventivo è di $9,167.
Entrambe le finestre dichiarate terminano entro 30 giorni, ma non posso promettere una data: ogni tempo di consegna conta i giorni lavorativi, si sospende mentre Essentras attende la tua approvazione della bozza e ha 3 giorni lavorativi di tolleranza. La carta viene addebitata al checkout e rimborsata se una pubblicazione non esce o se i tempi di consegna non sono rispettati.
Il passaggio umano
L'acquirente apre checkout_url, vede le stesse 2 inserzioni e il totale, e paga su essentras.com. Approvare in fretta le bozze è importante, perché i tempi di consegna restano sospesi mentre Essentras attende l'acquirente.
https://essentras.com/cart?add=bizjournals-com-dallas%2Cdallas-observer-6-month-lifespan&utm_source=ai_agent&utm_medium=agent_apiUtile anche
Le regole che l'agente segue
- Non paga mai e non raccoglie mai dati della carta. Il suo compito termina a checkout_url.
- Non presenta mai una pubblicazione a pagamento come la scelta di un giornalista di citare l'acquirente.
- Invia lo Stato per nome e cerca la città con q quando le inserzioni non riportano la città.
- Dichiara la propria regola di scelta e confronta ogni finestra dichiarata con la scadenza, senza promettere alcuna data.
- Non dà consulenza legale: uno studio legale verifica le proprie regole sulla pubblicità prima di acquistare.
- Non suggerisce mai le pubblicazioni come via per ottenere la rilevanza su Wikipedia o un badge Meta Verified.
FAQ
Domande su questa ricetta
Essentras può far citare il mio studio da un giornalista?▾
Nessuno può venderlo: è il giornalista a decidere chi citare. Essentras vende pubblicazioni a pagamento, che restano a pagamento qualunque etichetta aggiunga la testata, e l'agente lo dice.
Perché state TX non ha restituito nulla?▾
state confronta la regione così come la scrive ogni inserzione, cioè con il nome per esteso: Texas restituisce 31 inserzioni e TX ne restituisce 0. Le inserzioni non riportano nemmeno la città, quindi l'agente cerca il nome della città con q.
Le due pubblicazioni saranno online entro 30 giorni?▾
L'agente non può prometterlo. Le finestre dichiarate sono 1-2 settimane e 3 giorni lavorativi, conteggiate in giorni lavorativi, sospese mentre Essentras attende l'acquirente, più 3 giorni lavorativi di tolleranza. Un tempo di consegna non rispettato o una pubblicazione non uscita vengono rimborsati.
Un articolo a pagamento è consentito a uno studio legale?▾
L'agente non dà consulenza legale. Uno studio legale verifica le regole sulla pubblicità del proprio ordine prima di pagare per qualsiasi pubblicazione; ogni inserzione indica la propria etichetta in link.disclosure.