What this system is designed to answer every day
Abstract
A useful DTC monitor should not end with a dump of links, screenshots and engagement counts. It should first establish whether the owned store and its data sources are healthy, then record verifiable market and review movements, and finally convert the strongest evidence into a small review queue. The system therefore separates observed facts, interpretation and proposed action. It also records what could not be observed, because an access failure is not evidence that a competitor did nothing. In enterprise use, every observation and action must also resolve to one tenant, store, seat and credit ledger.
1. One router, deterministic execution and a review queue
The natural-language skill is only the entry and routing contract. Scheduling, run locks, retries, hashing, schema validation, baseline pointers and file output belong in a deterministic runner. Platform-specific access stays inside connectors, and every real external write remains outside the daily collection job.
QoderWork CN schedule / command
-> dtc-daily-ops-router
-> deterministic daily runner
-> tenant + seat policy / credit guard
-> SellerSprite + owned + competitor connectors
-> SignalEvent + AuditEvent evidence ledgers
-> ProductCandidate auto-selection
-> MultimodalOutreachPack per creator
-> DingTalk selection brief / Feishu outreach queue
-> credit ledger + delivery receipt + read-back
The product is not “more scraping.” The product is a daily, evidence-linked decision record that makes missing coverage visible.
2. Eight modules with separate responsibilities
01 · owned-store-health
Check whether the store can receive traffic
Checks priority pages, price, availability, CTA, structured data, media, links and configured analytics-event heartbeats.
02 · competitor-storefront-monitor
Detect public storefront changes
Tracks homepage offers, collections, PDPs, new or removed URLs, prices, availability, review deltas, content modules, JSON-LD and access failures.
03 · social-activity-monitor
Normalize social publishing activity
Records new videos and posts, cadence, topic, hook, CTA, product, partner and public metric snapshots where permitted.
04 · media-mention-monitor
Find publisher and newsroom movements
Uses feeds, sitemaps, newsroom pages and permitted search sources to detect launches, partnerships, reviews and distribution changes.
05 · public-ad-library-monitor
Observe public advertising evidence
Records creatives, copy, landing pages, first-seen and last-seen observations without inventing competitor spend or results.
06 · owned-channel-performance-reader
Read authorized operating data
Keeps Shopify, analytics, search and advertising metrics in their original timezone, currency, grain and attribution window.
07 · dtc-signal-synthesizer
Route evidence into products and creator actions
Deduplicates events, separates fact from inference, creates policy-scored ProductCandidates and links qualified review or competitor signals to an owned keyword, PDP, Listing or creator activation hypothesis.
08 · dtc-daily-brief-delivery
Deliver a five-minute operating brief
Prioritizes store risks, auto-selected product candidates, market movements and creator queues, delivers selection results through DingTalk CLI and manages batch outreach work through Feishu CLI with delivery read-back.
3. Eight gates that every daily run must pass
G0 · RUN IDENTITYCreate one auditable run
Locks business date, timezone, configuration hash and the previous successful baseline.
G1 · CONFIG & AUTHResolve tenant, store and seat authority
Every owned connection belongs to one tenant, is created by an administrator and resolves to explicit seat, store and action scopes. Secrets never enter reports or shared browser profiles.
G2 · OWNED STORE HEALTHPut owned failures first
A broken PDP, checkout path or event stream outranks an external opportunity.
G3 · COLLECTION COVERAGEAccount for every target
Success, partial access, rate limits and missing configuration are reported separately.
G4 · EVIDENCERequire traceable records
Events need a source URL, platform ID, timestamps, access method, rights state and raw evidence hash.
G5 · BASELINE & DIFFCompare only comparable observations
A first observation creates a baseline; missing values and failed fetches do not become price changes.
G6 · DECISION SAFETYKeep weak signals in Watch
Priority depends on evidence, relevance, novelty, persistence, readiness and risk—not likes alone.
G7 · ARTIFACT, AUDIT & SPENDReconcile output, operator and cost
Manifest counts, files, hashes, delivery receipts, seat audit events and credit-ledger entries must reconcile before the run is complete.
4. Public competitor signals and owned metrics are different products
The source contract distinguishes owned_authorized, competitor_official_public, public_observation and inferred. A number never moves between these scopes without retaining its original definition.
| Source | Competitor evidence | Owned authorized data | Do not claim |
|---|---|---|---|
| YouTube | Public uploads, metadata and public-count snapshots | Authorized channel analytics | Competitor CTR, retention, traffic source or revenue |
| Instagram / Meta | Eligible professional-account basics and active public ads | Owned account Insights and ad reporting | Competitor saves, reach, spend, conversions or ROAS |
| TikTok | Region-limited transparency data, Creative Center and permitted observations | Authorized organic and advertising reports | Global complete coverage or competitor performance |
| Google advertising | Advertiser, creative, region and served-date evidence | Authorized cost, click and conversion reports | Competitor cost, CTR, CVR or profitability |
| News / RSS / trends | Published title, date, source, topic and canonical URL | Owned Search Console and configured media records | Complete reach, PR effect or absolute Trends search volume |
| Reviews / search | Permitted public reviews, rating-distribution snapshots, recurring themes and freshness | Authorized Search Console, site-search, support and first-party review records | Reviewer identity, complete marketplace coverage or causality between one keyword and sales |
| Shopify / GA4 | No competitor backend access | Orders, refunds, inventory, traffic and funnel metrics | A single blended conversion count across different attribution systems |
Commerce truth rule: Shopify is the transaction ledger for owned orders, refunds and inventory. GA4 and each advertising platform keep their own attribution basis and maturity state; attributed conversions are not added together as store orders.
5. Five operating contracts, one access policy and two governance ledgers
SignalEvent
The evidence ledger
Stores platform ID, event type, source URL, published and observed times, region, collection method, raw evidence, metrics, rights, confidence and limitations.
ActionCandidate
The reviewable proposal
Links evidence to an owned SKU, page or campaign and adds priority, owner, prerequisites, approval state, acceptance metric and rollback condition.
ProductCandidate
The automatically selected product record
Stores the SellerSprite evidence snapshot, marketplace, category, demand and keyword signals, competition, price band, review gaps, unit-economics assumptions, logistics, compliance, supplier readiness, hard-gate results, score, decision and expiry.
MultimodalOutreachPack
One evidence-linked creator package
Links creator evidence and eligibility to one Product Truth Card, then stores the personalized outreach message, content angle, visual references, short-video storyboard, claims boundary, asset rights, send state and follow-up state.
AccessGrant
The enforceable access policy
Defines tenant, seat, role, allowed stores, connectors, actions, approval rights, issuer, validity period and revocation state. A logged-in browser session never widens this grant.
AuditEvent
The append-only operator record
Records tenant, actor seat, target store, action, scope, approval, request ID, result, timestamp and read-back outcome without storing passwords, tokens or raw cookies.
CreditLedgerEntry
The allocation and spend record
Links the enterprise pool, seat or project allocation, reservation, charge, refund, idempotency key, remaining balance and the run that caused the movement.
RunManifest
The completion proof
Records configuration hash, tenant and actor seat, connector states, coverage, baseline pointers, artifact hashes, errors, review counts, credit reservation and consumption, and delivery receipt.
Null semantics
Missing is not zero
Unavailable metrics remain null or NA. First observations are baselines. Access failures and stale data cannot trigger strong business actions.
observed evidence
-> explicit interpretation
-> proposed action
-> pending_human_review
-> approved operator execution
-> read-back verification
6. No-manual product selection and evidence-led creator activation
The current operating route uses QoderWork CN as the orchestrator, SellerSprite as an authorized product, keyword and review evidence source, DingTalk CLI as the internal selection-delivery surface, and Feishu CLI as the batch creator-work queue. “No manual selection” means the daily run does not rely on a person browsing products and picking favorites; administrators own the policy and hard thresholds, while the runner makes the candidate decision deterministically.
01 · QODERWORK CN
Orchestrate the run and its policy
Loads marketplace, category, business-date, threshold and exclusion configuration, creates one run ID and invokes the deterministic selector without hand-picking SKUs.
02 · SELLERSPRITE EVIDENCE
Collect product, keyword and review evidence
Preserves the authorized source method, snapshot time, marketplace and definition for demand, keyword structure, competition, price range, review pain points and trend signals. Missing fields remain unknown.
03 · HARD-GATE SELECTOR
Select automatically, reject deterministically
Required gates cover evidence freshness, demand, competition, price and margin assumptions, logistics, seasonality, review opportunity, compliance and supplier readiness. A candidate becomes AUTO_SELECTED only when every required gate passes.
04 · DINGTALK CLI DELIVERY
Deliver decisions, not a pile of product links
Sends the selected list, rejected hard gates, evidence links, score reasons, data expiry and downstream execution boundary to the configured DingTalk destination, then verifies delivery.
05 · CREATOR ELIGIBILITY
Deduplicate, score and suppress before outreach
Matches public or authorized creator evidence to audience, market, format, product fit, brand safety, previous contact, consent basis, suppression list and contact-channel eligibility.
06 · MULTIMODAL PERSONALIZATION
Generate one truthful package per creator
Combines the creator evidence snapshot with the SKU Product Truth Card to create personalized outreach copy, a creator-specific hook, visual direction, reference frame, short-video storyboard and talking points without fabricating experience or claims.
07 · FEISHU CLI BATCH QUEUE
Manage batch outreach as an auditable queue
Creates or updates one row per creator with owner, channel, personalized pack, approval, send window, rate limit, dedupe key, reply state, next follow-up and suppression reason. Feishu is the operations control surface, not assumed to be every external delivery channel.
08 · APPROVED SEND & READ-BACK
Scale outreach without blind mass messaging
An approved roster and campaign policy may unlock batch execution through an authorized channel connector. Quiet hours, channel limits, opt-outs, bounces, duplicate contact and negative replies suppress later sends; delivery and replies are read back into the queue.
QoderWork CN
-> SellerSprite evidence snapshot
-> ProductCandidate hard gates + ranking
-> AUTO_SELECTED / REJECTED_HARD_GATE / NEEDS_FRESH_DATA
-> DingTalk CLI selection brief
Creator evidence + Product Truth Card
-> MultimodalOutreachPack
-> Feishu CLI batch work queue
-> approved external channel
-> delivery / reply / follow-up read-back
Automation boundary: there is no manual SKU picking inside the daily selection run, but procurement, samples, supplier outreach, Listing publication and advertising spend remain separate approved actions. Creator research and multimodal package generation can run in batch; outbound contact requires an approved roster, lawful contact basis, channel policy, rate limits and suppression handling. Tool access and connector methods must be verified per deployment.
ChatGPT referral and GEO loop: validated ChatGPT sessions and orders become demand evidence for query coverage and product selection; Product Truth then keeps the PDP, structured data, feeds and creator packs aligned. See the detailed ChatGPT Commerce GEO method for attribution states, crawl controls, feed freshness, experiments and conversion-quality measurement.
7. Enterprise teams need a control plane, not shared credentials
Enterprise access is evaluated per tenant, acting seat, assigned store, connector, action and validity period. Effective access is the narrowest intersection of role, store assignment, connector scope, approval policy, credit budget and time window—not whatever a logged-in browser happens to expose.
01 · ADMIN CONNECTION
Administrators own store connections
Only a Tenant Admin can create, renew or revoke Shopify, advertising, social or managed-browser connections. Seats receive scoped grants, never reusable credentials.
02 · LEAST-PRIVILEGE SEATS
Read, execute and approve are separate
Analyst seats are read-only by default. Execution and approval are separate permissions, limited by store, connector, action and validity period; seats cannot widen their own access.
03 · TENANT ISOLATION
Every record remains inside one enterprise
Stores, grants, browser-profile mappings, evidence, reports, schedules, secrets, approvals and credit ledgers carry a tenant ID end to end. Cross-tenant reads, joins, exports and cache reuse are denied by default.
04 · ADMIN AUDIT VIEW
Important activity is visible by seat
Connection changes, grants, run starts, exports, approvals, write attempts, credit allocation and consumption, and revocation results create append-only audit events.
05 · BROWSER SESSION BOUNDARY
A browser profile is not permission
ZiNiao (Purple Bird), or any other fingerprint or multi-account browser, is only an external access container—never the authorization system. The router uses admin-bound profile-to-store mappings, never exports cookies, reuses profiles across tenants or infers extra authority from an existing login.
06 · HIGH-RISK APPROVAL
Privileged writes require a second decision
Price, inventory, publishing, campaign, budget, targeting, export and connection changes require an authorized operator, an eligible approver and read-back verification.
07 · CREDIT BUDGETS
The enterprise pool is allocatable and capped
Purchased credits enter an enterprise pool. Billing Admins allocate seat, store or project caps; paid runs reserve first, settle once and alert before a hard stop. No negative balance, silent retry or automatic top-up.
08 · OFFBOARDING & REVOKE
Leaving means immediate revocation
Offboarding suspends the seat, ends sessions and grants, unbinds managed browsers, blocks pending writes, transfers schedules and rotates shared credentials while retaining audit history.
Tenant Admin connects store
-> server-side credential reference
-> seat receives scoped AccessGrant
-> tenant + store + role + action + credit check
-> approval when required
-> AuditEvent + CreditLedgerEntry
-> read-back verification or explicit revoke state
Enterprise status boundary: these are implementation requirements, not a claim that seat enforcement, complete audit coverage, ZiNiao or other managed-browser security, credit allocation or automatic offboarding is already deployed. This system cannot guarantee the security of a third-party browser. Audit coverage includes only activity this system observes or initiates; direct platform activity depends on each platform's own logs. Credit limits govern this system's credits, not advertising spend or third-party fees. Revocation is complete only after every connected system confirms it.
8. The daily brief should take five minutes to read
- Owned-store red lights: page, checkout, inventory, tracking or connector failures that need attention first.
- Top external movements: the most relevant storefront, social, media and public-ad changes.
- Owned performance context: store-truth outcomes and platform metrics with attribution and maturity labels.
- Review and search gaps: new recurring customer language connected to an owned search term, PDP or Listing hypothesis—not an automatic rewrite.
- At most three actions: fix, test or keep watching—with owner, evidence and acceptance metric.
- Team-control exceptions: role or seat changes, expiring grants, blocked scope attempts, privileged operations, credit use against assigned caps and pending revocations.
- Data boundaries: sources that were blocked, stale, unsupported or not configured.
SUCCESSPARTIALAUTO_SELECTEDREJECTED_HARD_GATEOUTREACH_SUPPRESSEDBASELINE_CREATEDNOT_CONFIGUREDACCESS_LIMITEDBLOCKED_AUTHBLOCKED_SCOPECREDIT_LIMIT_REACHEDREVOCATION_PENDINGSTALE_DATANEEDS_FRESH_DATANEEDS_HUMAN_REVIEW
If successful coverage is zero, the report becomes an access-limited operating alert. It must not recycle historical signals into a new competitor conclusion.
9. Read-only collection first; execution requires approval
- Automatically allowed: permitted reading, snapshots, hashing, normalization, comparison, calculations, local reports and alerts to a pre-approved destination—only within the acting seat's tenant, store and source scopes.
- Human approval required: changes to storefronts, prices, inventory, content, advertising budgets, bids, targeting, campaign state, outreach or publishing. Operator, approver and read-back outcome enter the audit trail.
- No credential sharing: seats cannot view, export or reuse another seat's password, token, cookie or browser session. Possession of a browser profile does not grant store authority.
- No hidden credit spend: paid work is charged to an approved seat, store or project cap. Reaching the limit stops the paid step or requests administrator approval; it never triggers a silent purchase.
- No blind outreach or identity fabrication: batch creator work must deduplicate contacts, respect rate limits and suppression lists, and preserve review before send. Multimodal personalization may adapt a truthful SKU story to a creator's public audience context; it cannot clone a creator's face or voice, claim a past partnership or invent product use.
- No access-control bypass: no login-wall, CAPTCHA, private-account, robots or platform-rate-limit circumvention.
- No competitor result invention: ad duration, likes or creative repetition do not prove spend, sales, conversion, profitability or winning creative.
- Current status: this page is a reviewed design specification. It does not claim that every listed API connector, scheduled job or delivery integration is already deployed.
Primary platform references
- YouTube Data API — Channels
- Meta — Instagram Business Discovery
- Meta Ad Library
- TikTok Commercial Content API
- Google Ads Transparency Center
- Shopify Admin GraphQL — Orders
- GA4 — Reporting data expectations
- Google Search Console — Performance data
Turn the design into a running daily system
Implementation starts with schemas, tenant isolation, administrator-owned connections, seat policies, audit and credit ledgers, the existing storefront monitor and a read-only daily brief before any account execution is considered.