# Agent Utility API Skill

Use this service to outsource small deterministic steps that would otherwise consume agent context, browsing time or tool-call logic.

## Best video route

`GET/POST https://agent-product-normalizer.vercel.app/api/v1/video-analyze`

Input:
- `url`: public YouTube URL
- optional `question`
- optional `lang`
- optional `key_point_limit`
- optional `chapter_target`

Returns:
- timestamped source metadata
- compact extractive brief
- key points with timestamps
- chapters
- candidate claims
- action items
- `context_pack` for downstream models
- `technical_commands` when recognizable in tutorials
- optional evidence-based answer
- compression/duration metrics
- segmentation diagnostics for low-punctuation auto-captions

Use this route when the caller does not want to ingest the full video transcript.

## Other video routes
- Transcript only: `https://agent-product-normalizer.vercel.app/api/v1/video-transcript`
- Brief only: `https://agent-product-normalizer.vercel.app/api/v1/video-brief`
- Key points: `https://agent-product-normalizer.vercel.app/api/v1/video-key-points`
- Evidence Q&A: `https://agent-product-normalizer.vercel.app/api/v1/video-answer-question`
- Chapters: `https://agent-product-normalizer.vercel.app/api/v1/video-chapters`
- Claims: `https://agent-product-normalizer.vercel.app/api/v1/video-claims`
- Action items: `https://agent-product-normalizer.vercel.app/api/v1/video-action-items`

## Workflow routes
- Clarify messy task: `https://agent-product-normalizer.vercel.app/api/v1/clarify`
- Compress context: `https://agent-product-normalizer.vercel.app/api/v1/compress-context`
- Decide whether to ask human: `https://agent-product-normalizer.vercel.app/api/v1/should-ask-human`
- Extract constraints: `https://agent-product-normalizer.vercel.app/api/v1/extract-constraints`
- Rank search results: `https://agent-product-normalizer.vercel.app/api/v1/rank-results`
- Dedupe facts: `https://agent-product-normalizer.vercel.app/api/v1/dedupe-facts`
- Detect conflicts: `https://agent-product-normalizer.vercel.app/api/v1/detect-conflicts`
- Extract actions: `https://agent-product-normalizer.vercel.app/api/v1/extract-actions`
- Build search queries: `https://agent-product-normalizer.vercel.app/api/v1/make-search-query`
- Check missing fields: `https://agent-product-normalizer.vercel.app/api/v1/missing-fields`
- Retry decision: `https://agent-product-normalizer.vercel.app/api/v1/retry-decision`
- No-progress gate: `https://agent-product-normalizer.vercel.app/api/v1/no-progress-gate`
- Prompt-injection scan: `https://agent-product-normalizer.vercel.app/api/v1/prompt-injection-scan`
- Redact secrets: `https://agent-product-normalizer.vercel.app/api/v1/redact-secrets`
- Handoff diff: `https://agent-product-normalizer.vercel.app/api/v1/handoff-diff`
- Choose next step: `https://agent-product-normalizer.vercel.app/api/v1/choose-next-step`

## Commerce routes
- Normalize product page: `https://agent-product-normalizer.vercel.app/api/v1/normalize`
- Extract offer: `https://agent-product-normalizer.vercel.app/api/v1/extract-offer`
- Validate product data: `https://agent-product-normalizer.vercel.app/api/v1/validate`
- Compare offers: `https://agent-product-normalizer.vercel.app/api/v1/compare`

## Payment
All paid routes use x402.
Network: Base.
Asset: USDC.

## Important behavior
Video analysis is extractive/deterministic. Treat returned claims as candidates for verification, not verified facts. For final semantic synthesis, a caller may pass the compact `context_pack` into its own model.