Catalog Web Import Agent
poetry add enthusiast-agent-catalog-web-importThe Catalog Web Import agent accepts one or more product page URLs and extracts structured product data directly from those pages. It uses browser-level TLS impersonation to fetch pages reliably, passes the content through an LLM to pull out the fields defined in your schema, and upserts all products in a single batch. When confirmation mode is enabled, it presents the extracted data for review before writing anything to the catalog.
Use Cases
- Supplier Website Onboarding – When a supplier shares their product catalog as a website rather than a document, the agent can scrape and import all relevant product pages directly, eliminating manual copy-paste.
- Catalog Expansion from Distributor Pages – Sales teams can drop in a list of distributor or manufacturer product URLs and have all products extracted and added to the catalog in one go, without leaving the chat interface.
- Bulk Multi-URL Import – Provide dozens of product page URLs in a single request and the agent fetches them in parallel, reconciles any overlapping data, and upserts everything in one batch call.
Installing Catalog Web Import Agent
This agent is built on the Enthusiast domain definition, so a Suvereo instance with the domain definition installed is required. If you haven't set it up yet, follow the installation guide first.
In the Suvereo starter, add the package to your server package in server/src.
poetry add enthusiast-agent-catalog-web-importThen, register the agent in server/config/settings_override.py.
AVAILABLE_AGENTS = [
'enthusiast_agent_catalog_web_import.CatalogWebImportAgent',
]To run the agent as an agentic execution through the API, also register its execution definition.
AVAILABLE_AGENTIC_EXECUTION_DEFINITIONS = [
'enthusiast_agent_catalog_web_import.CatalogWebImportAgenticExecutionDefinition',
]Then, rebuild and restart the containers (docker compose build && docker compose up) for the newly installed agent to become available.