7649f19e33
Add a domain-discovery step to the enrichment pipeline so the catalog's domain set, previously written only by the curated seed, grows automatically. A focused agent enumerates the registrable domains a vendor owns and operates - marketing, product and sub-brand, app, API, and CDN/asset domains - from links seen while browsing and from web search, anchored on the website resolved earlier in the run. A deterministic ownership gate reduces the candidates to eTLD+1 and keeps only those that clear a strict confidence floor and match the vendor by domain label. Shared tracker-delivery and CDN infrastructure is dropped unless the vendor itself is that provider, in which case its own brand-matching domain passes a stricter exact-label check. The survivors are upserted into common_third_party_domains in the run's final transaction and recorded in the enrichment payload, feeding the tracker-mapping domain step and disambiguation. Signed-off-by: Émile Ré <emile@probo.com>
103 lines
3.9 KiB
Go
103 lines
3.9 KiB
Go
// Copyright (c) 2026 Probo Inc <hello@getprobo.com>.
|
|
//
|
|
// Permission to use, copy, modify, and/or distribute this software for any
|
|
// purpose with or without fee is hereby granted, provided that the above
|
|
// copyright notice and this permission notice appear in all copies.
|
|
//
|
|
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
|
|
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
|
|
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
|
|
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
|
|
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
|
|
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
|
// PERFORMANCE OF THIS SOFTWARE.
|
|
|
|
package thirdparty
|
|
|
|
import (
|
|
_ "embed"
|
|
"fmt"
|
|
"strings"
|
|
|
|
"go.gearno.de/kit/log"
|
|
"go.probo.inc/probo/pkg/agent"
|
|
"go.probo.inc/probo/pkg/agent/tools/search"
|
|
)
|
|
|
|
//go:embed prompts/common_third_party_domains.txt.tmpl
|
|
var domainsPrompt string
|
|
|
|
// DomainsResult is the structured output of the domain-discovery agent
|
|
// (Agent C): the registrable domains the vendor itself owns and operates,
|
|
// including the marketing site, app, public API hosts, and CDN/asset
|
|
// hosts. The worker reduces these to eTLD+1, applies an ownership gate,
|
|
// and writes the survivors to common_third_party_domains so the
|
|
// tracker-mapping domain step can attribute trackers to this vendor.
|
|
type (
|
|
DomainsResult struct {
|
|
Domains []DomainCandidate `json:"domains" jsonschema:"The domains the vendor owns and operates. Empty when none can be confirmed."`
|
|
}
|
|
|
|
DomainCandidate struct {
|
|
Domain string `json:"domain" jsonschema:"A domain the vendor owns and operates (a registrable domain such as 'intercomcdn.com' or a full host such as 'api.vendor.com'). Never a third-party or shared-infrastructure host the vendor does not own."`
|
|
Confidence float64 `json:"confidence" jsonschema:"Confidence from 0.0 to 1.0 that the vendor owns this domain. Use 0 when ownership is not confirmed."`
|
|
SourceURL string `json:"source_url" jsonschema:"The URL where the vendor's ownership of this domain was observed, or an empty string."`
|
|
}
|
|
)
|
|
|
|
// buildCommonThirdPartyDomainsAgent builds Agent C. extraTools carries
|
|
// the browser read-only toolset when a headless Chrome endpoint is
|
|
// configured; it is empty otherwise, in which case the agent relies on
|
|
// web_search alone.
|
|
func buildCommonThirdPartyDomainsAgent(
|
|
cfg EnrichmentConfig,
|
|
logger *log.Logger,
|
|
extraTools []agent.Tool,
|
|
) *agent.Agent {
|
|
tools := append([]agent.Tool{}, extraTools...)
|
|
|
|
if cfg.FirecrawlAPIKey != "" {
|
|
tools = append(tools, search.FirecrawlSearchTool(cfg.FirecrawlAPIKey))
|
|
}
|
|
|
|
outputType, err := agent.NewOutputType[DomainsResult]("common_third_party_domains")
|
|
if err != nil {
|
|
panic(fmt.Sprintf("thirdparty: cannot build domains output type: %s", err))
|
|
}
|
|
|
|
opts := []agent.Option{
|
|
agent.WithInstructions(domainsPrompt),
|
|
agent.WithModel(cfg.Model),
|
|
agent.WithOutputType(outputType),
|
|
agent.WithMaxTurns(resolveEnrichmentMaxTurns(cfg.MaxTurns)),
|
|
agent.WithMaxTokens(resolveEnrichmentMaxTokens(cfg.MaxTokens)),
|
|
agent.WithLogger(logger),
|
|
}
|
|
|
|
if len(tools) > 0 {
|
|
opts = append(opts, agent.WithTools(tools...))
|
|
}
|
|
|
|
if cfg.Temperature != nil {
|
|
opts = append(opts, agent.WithTemperature(*cfg.Temperature))
|
|
}
|
|
|
|
return agent.New("common-third-party-domains", cfg.LLMClient, opts...)
|
|
}
|
|
|
|
// buildCommonThirdPartyDomainsPrompt renders the per-row input for Agent
|
|
// C, seeding it with the vendor name and the website resolved by Agent A
|
|
// so it can anchor ownership to the vendor's own domain.
|
|
func buildCommonThirdPartyDomainsPrompt(name, websiteURL string) string {
|
|
var b strings.Builder
|
|
|
|
fmt.Fprintf(&b, "Find the domains owned and operated by this vendor.\n\n")
|
|
fmt.Fprintf(&b, "<name> %s </name>\n", name)
|
|
|
|
if w := strings.TrimSpace(websiteURL); w != "" {
|
|
fmt.Fprintf(&b, "<website> %s </website>\n", w)
|
|
}
|
|
|
|
return b.String()
|
|
}
|