@ucptools/validator 1.0.0

package/apify-actor/.actor/actor.json

@@ -0,0 +1,68 @@
+{
+  "actorSpecification": 1,
+  "name": "ucp-profile-validator",
+  "title": "UCP Profile Validator",
+  "description": "Validate any merchant's Universal Commerce Protocol (UCP) business profile at /.well-known/ucp. Check AI commerce readiness with instant A-F grading, detailed issue reports, and fix recommendations. Essential for e-commerce stores preparing for AI shopping agents.",
+  "version": "1.0",
+  "buildTag": "latest",
+  "environmentVariables": {},
+  "dockerfile": "./Dockerfile",
+  "input": "./input_schema.json",
+  "readme": "./README.md",
+  "storages": {
+    "dataset": {
+      "actorSpecification": 1,
+      "title": "UCP Validation Results",
+      "description": "Validation results for UCP business profiles including compliance scores, issues found, and fix recommendations.",
+      "views": {
+        "overview": {
+          "title": "Validation Overview",
+          "description": "Summary of validation results with grades and issue counts.",
+          "transformation": {
+            "fields": ["domain", "valid", "grade", "score", "errors", "warnings", "ucpVersion", "checkedAt"]
+          },
+          "display": {
+            "component": "table",
+            "properties": {
+              "domain": { "label": "Domain", "format": "text" },
+              "valid": { "label": "Valid", "format": "boolean" },
+              "grade": { "label": "Grade", "format": "text" },
+              "score": { "label": "Score", "format": "number" },
+              "errors": { "label": "Errors", "format": "number" },
+              "warnings": { "label": "Warnings", "format": "number" },
+              "ucpVersion": { "label": "UCP Version", "format": "text" },
+              "checkedAt": { "label": "Checked At", "format": "date" }
+            }
+          }
+        },
+        "issues": {
+          "title": "Issues Detail",
+          "description": "Detailed list of all validation issues found.",
+          "transformation": {
+            "fields": ["domain", "grade", "issues"]
+          },
+          "display": {
+            "component": "table",
+            "properties": {
+              "domain": { "label": "Domain", "format": "text" },
+              "grade": { "label": "Grade", "format": "text" },
+              "issues": { "label": "Issues", "format": "array" }
+            }
+          }
+        }
+      }
+    }
+  },
+  "useCases": [
+    "Validate your store's UCP profile before AI agent integration",
+    "Audit competitor UCP readiness",
+    "Monitor multiple merchant profiles for compliance",
+    "Pre-launch check for headless commerce deployments",
+    "Agency bulk validation of client stores"
+  ],
+  "exampleRunInput": {
+    "domain": "google.com",
+    "mode": "full",
+    "includeRecommendations": true
+  }
+}

package/apify-actor/.actor/input_schema.json

@@ -0,0 +1,32 @@
+{
+  "title": "UCP Profile Validator",
+  "description": "Enter a domain to validate its UCP (Universal Commerce Protocol) business profile. The validator fetches the profile from <code>/.well-known/ucp</code> and checks compliance with the <a href=\"https://ucp.dev/specification/overview/\" target=\"_blank\">official UCP specification</a>.<br><br><b>Quick start:</b> Just enter a domain and click Run. For help generating a valid profile, visit <a href=\"https://ucptools.dev\" target=\"_blank\">ucptools.dev</a>.",
+  "type": "object",
+  "schemaVersion": 1,
+  "properties": {
+    "domain": {
+      "title": "Domain",
+      "type": "string",
+      "description": "Enter the merchant domain to validate (without https://). We'll fetch and validate the profile at <code>https://{domain}/.well-known/ucp</code>",
+      "editor": "textfield",
+      "prefill": "google.com",
+      "example": "shopify.com"
+    },
+    "mode": {
+      "title": "Validation Mode",
+      "type": "string",
+      "description": "Choose validation depth:<br>• <b>Full</b> - Complete validation including network checks (recommended)<br>• <b>Quick</b> - Structural validation only, faster but less thorough",
+      "editor": "select",
+      "default": "full",
+      "enum": ["full", "quick"],
+      "enumTitles": ["Full (recommended)", "Quick (structural only)"]
+    },
+    "includeRecommendations": {
+      "title": "Include Fix Recommendations",
+      "type": "boolean",
+      "description": "When enabled, the output includes actionable recommendations for fixing each issue found. Useful for developers implementing UCP for the first time.",
+      "default": true
+    }
+  },
+  "required": ["domain"]
+}

package/apify-actor/APIFY-STORE-LISTING.md

@@ -0,0 +1,412 @@
+# Apify Store Listing - UCP Profile Validator
+
+Complete copy-paste content for Apify Store publication. Updated January 2026.
+
+---
+
+## 1. DISPLAY INFORMATION
+
+### Actor Name
+```
+ucp-profile-validator
+```
+
+### Title
+```
+UCP Profile Validator
+```
+
+### Description (exactly 300 characters)
+```
+Validate any merchant's Universal Commerce Protocol (UCP) business profile at /.well-known/ucp. Check AI commerce readiness with instant A-F grading, detailed issue reports, and fix recommendations. Essential for e-commerce stores preparing for AI shopping agents.
+```
+*Character count: 299*
+
+### SEO Title (40-50 characters)
+```
+UCP Profile Validator - AI Commerce Readiness Check
+```
+*Character count: 50*
+
+### SEO Description (140-156 characters)
+```
+Free UCP profile validator. Check if your store's /.well-known/ucp endpoint is ready for AI shopping agents. Get instant A-F grade with fix recommendations.
+```
+*Character count: 156*
+
+---
+
+## 2. CATEGORIES & TAGS
+
+### Primary Category
+```
+Developer Tools
+```
+
+### Additional Categories
+```
+E-commerce
+SEO Tools
+```
+
+### Tags/Keywords (comma-separated)
+```
+ucp, universal commerce protocol, ai commerce, ecommerce validation, api validation, schema validation, well-known, ai shopping, agent commerce, google ucp, shopify ucp, ai agents, commerce api, merchant profile
+```
+
+---
+
+## 3. PRICING CONFIGURATION
+
+### Pricing Model
+```
+Pay per event (PAY_PER_EVENT) with Synthetic Events
+```
+
+### Why Pay Per Event?
+
+| Model | Status | AI/MCP Compatible | Notes |
+|-------|--------|-------------------|-------|
+| Free | Available | Yes | No revenue |
+| Rental | Available | **No** | Incompatible with AI agents |
+| Pay Per Result | **DEPRECATED** | Yes | Being removed in 2026 |
+| **Pay Per Event** | **RECOMMENDED** | Yes | Most flexible, future-proof |
+
+### Why Use Synthetic Events (No Code Needed!)
+
+Apify provides **synthetic events** that auto-charge without any `Actor.charge()` code:
+
+1. **`apify-actor-start`** - Auto-charged when actor starts
+   - **Apify covers first 5 seconds of compute FREE**
+   - Default price: $0.00005 per start
+
+2. **`apify-default-dataset-item`** - Auto-charged on each `Actor.pushData()`
+   - You set the price per result
+   - No code changes needed - just configure in Console
+
+### Recommended Event Configuration
+
+| Event | Type | Price | Description |
+|-------|------|-------|-------------|
+| `apify-actor-start` | Synthetic (auto) | $0.00005 | Charged per run start (Apify subsidizes first 5 sec) |
+| `apify-default-dataset-item` | Synthetic (auto) | $0.001 | Charged per validation result |
+
+### Tiered Pricing for `apify-default-dataset-item`
+
+| Tier | Price per Result | Price per 1,000 |
+|------|-----------------|-----------------|
+| FREE | $0.002 | $2.00 |
+| BRONZE | $0.0018 | $1.80 |
+| SILVER | $0.0015 | $1.50 |
+| GOLD | $0.001 | $1.00 |
+| PLATINUM | $0.001 | $1.00 |
+| DIAMOND | $0.001 | $1.00 |
+
+### Example Cost Calculation
+
+For 100 validations on FREE tier:
+- Actor starts: 100 × $0.00005 = $0.005
+- Results: 100 × $0.002 = $0.20
+- **Total: $0.205** (~$2.05 per 1,000 validations)
+
+For 100 validations on GOLD tier:
+- Actor starts: 100 × $0.00005 = $0.005
+- Results: 100 × $0.001 = $0.10
+- **Total: $0.105** (~$1.05 per 1,000 validations)
+
+### Revenue Calculation
+
+You receive 80% of revenue minus platform costs:
+- Revenue from 1,000 validations (GOLD): $1.05
+- Platform cost estimate: ~$0.10
+- **Your profit: (0.8 × $1.05) - $0.10 = $0.74**
+
+### Why This Pricing Works
+
+1. **No code needed** - Synthetic events handle charging automatically
+2. **Apify subsidizes startup** - First 5 sec compute is free
+3. **Competitive** - Similar to email validators ($0.001-0.002)
+4. **AI/MCP compatible** - Essential for future AI agent integrations
+5. **Future-proof** - PPR is deprecated, PPE is the standard
+
+---
+
+## 4. INPUT SCHEMA
+
+Already configured in `.actor/input_schema.json`:
+
+```json
+{
+  "title": "UCP Profile Validator",
+  "description": "Enter a domain to validate its UCP (Universal Commerce Protocol) business profile...",
+  "type": "object",
+  "schemaVersion": 1,
+  "properties": {
+    "domain": {
+      "title": "Domain",
+      "type": "string",
+      "description": "Enter the merchant domain to validate (without https://)...",
+      "editor": "textfield",
+      "prefill": "google.com",
+      "example": "shopify.com"
+    },
+    "mode": {
+      "title": "Validation Mode",
+      "type": "string",
+      "default": "full",
+      "enum": ["full", "quick"],
+      "enumTitles": ["Full (recommended)", "Quick (structural only)"]
+    },
+    "includeRecommendations": {
+      "title": "Include Fix Recommendations",
+      "type": "boolean",
+      "default": true
+    }
+  },
+  "required": ["domain"]
+}
+```
+
+---
+
+## 5. OUTPUT SCHEMA
+
+### Output Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `domain` | string | The validated domain |
+| `profileUrl` | string | Full URL of the UCP profile |
+| `valid` | boolean | Whether profile passes validation |
+| `score` | number | Compliance score 0-100 |
+| `grade` | string | Letter grade A-F |
+| `ucpVersion` | string | Detected UCP spec version |
+| `errors` | number | Count of error-level issues |
+| `warnings` | number | Count of warning-level issues |
+| `issues` | array | Detailed list of all issues found |
+| `recommendations` | array | Actionable fix suggestions |
+| `checkedAt` | string | ISO timestamp of validation |
+| `generatorUrl` | string | Link to profile generator tool |
+
+### Sample Output
+```json
+{
+  "domain": "example.com",
+  "profileUrl": "https://example.com/.well-known/ucp",
+  "valid": false,
+  "score": 60,
+  "grade": "D",
+  "ucpVersion": "2026-01-11",
+  "errors": 2,
+  "warnings": 1,
+  "issues": [
+    {
+      "severity": "error",
+      "code": "UCP_NS_MISMATCH",
+      "message": "dev.ucp.* spec must be on ucp.dev"
+    }
+  ],
+  "recommendations": [
+    "Fix all errors before deploying",
+    "Add signing_keys for Order capability"
+  ],
+  "checkedAt": "2026-01-14T12:00:00.000Z",
+  "generatorUrl": "https://ucptools.dev/generate"
+}
+```
+
+---
+
+## 6. EXAMPLE INPUTS
+
+### Basic Input
+```json
+{
+  "domain": "google.com"
+}
+```
+
+### Full Options
+```json
+{
+  "domain": "mystore.com",
+  "mode": "full",
+  "includeRecommendations": true
+}
+```
+
+### Quick Validation
+```json
+{
+  "domain": "mystore.com",
+  "mode": "quick"
+}
+```
+
+---
+
+## 7. USE CASES (for Store listing)
+
+Copy these directly:
+
+```
+- Validate your store's UCP profile before AI agent integration
+- Audit competitor UCP readiness
+- Monitor multiple merchant profiles for compliance
+- Pre-launch check for headless commerce deployments
+- Agency bulk validation of client stores
+```
+
+---
+
+## 8. FAQ CONTENT
+
+### Q: What is UCP?
+```
+The Universal Commerce Protocol is an open standard by Google, Shopify, and others that enables AI agents to discover and shop at online stores. Merchants publish a profile at /.well-known/ucp describing their capabilities.
+```
+
+### Q: Why do I need this validator?
+```
+If your UCP profile has errors, AI shopping agents won't be able to find or transact with your store. This validator catches issues before they become problems, ensuring you're ready when AI commerce goes mainstream.
+```
+
+### Q: What does the grade mean?
+```
+A = Fully compliant (90-100 score)
+B = Minor issues (80-89)
+C = Several issues (70-79)
+D = Significant problems (60-69)
+F = Broken or missing (0-59)
+```
+
+### Q: How do I fix issues?
+```
+Each issue includes an error code and recommendation. Visit https://ucptools.dev/generate to create a new profile from scratch, or manually fix the issues based on the recommendations provided.
+```
+
+### Q: Can I validate multiple domains?
+```
+Yes! Use the Apify API or schedules to validate multiple domains in bulk. Perfect for agencies managing many stores or monitoring competitors.
+```
+
+### Q: Is this affiliated with Google or Shopify?
+```
+No. UCP.tools is an independent project that validates against the official UCP specification. We are not affiliated with Google, Shopify, or any other UCP consortium member.
+```
+
+---
+
+## 9. ICON/LOGO
+
+Recommended: Create a simple icon featuring:
+- Checkmark or shield symbol (validation/security)
+- Commerce/shopping cart element
+- Colors: Blue (#2563eb) and green (#16a34a)
+- Do NOT use Google, Shopify, or UCP consortium logos
+
+---
+
+## 10. AUTHOR INFORMATION
+
+### Developer Name
+```
+UCP.tools
+```
+
+### Website
+```
+https://ucptools.dev
+```
+
+### Support Email
+```
+hello@ucptools.dev
+```
+
+---
+
+## 11. PUBLICATION CHECKLIST
+
+### Before Publishing
+- [x] Actor code tested and working
+- [x] README.md complete with all sections
+- [x] Input schema with descriptions and prefills
+- [x] Output schema with dataset views
+- [x] actor.json with metadata and use cases
+- [x] Description exactly 300 characters
+- [x] SEO title and description set
+- [ ] Icon/logo uploaded
+- [ ] Categories selected
+- [ ] Tags added
+- [ ] Pricing configured
+
+### After Publishing
+- [ ] Test run from Store page
+- [ ] Verify output displays correctly
+- [ ] Check SEO by searching "UCP validator Apify"
+- [ ] Share on social media
+- [ ] Add Actor badge to ucptools.dev website
+
+---
+
+## 12. DEPLOYMENT COMMANDS
+
+### Push to Apify
+```bash
+cd ucp-profile-manager/apify-actor
+apify push
+```
+
+### Test Run via CLI
+```bash
+apify call ucp-profile-validator -i '{"domain": "google.com"}'
+```
+
+### View Actor (Console)
+```
+https://console.apify.com/actors/zNlcAOgvdpdzblpIA
+```
+
+### Store Listing (Public)
+```
+https://apify.com/minute_contest/ucp-profile-validator
+```
+
+---
+
+## 13. PROMOTION CHECKLIST
+
+After publishing:
+
+1. **Apify Community**
+   - Post in Apify Discord
+   - Share on Apify community forum
+
+2. **Social Media**
+   - Twitter: Announce with #AICommerce #UCP hashtags
+   - LinkedIn: Post about AI commerce readiness
+
+3. **SEO**
+   - Add Actor to ucptools.dev website
+   - Create blog post about UCP validation
+
+4. **Integrations**
+   - Add to n8n community nodes list
+   - Create Make.com integration template
+   - Build Zapier integration
+
+---
+
+## 14. VERSION HISTORY
+
+### v1.0 (2026-01-14)
+- Initial release
+- Full UCP spec validation
+- A-F grading system
+- Fix recommendations
+- Quick and full validation modes
+
+---
+
+*Last updated: January 14, 2026*

package/apify-actor/Dockerfile

@@ -0,0 +1,8 @@
+FROM apify/actor-node:20
+
+COPY --chown=myuser package*.json ./
+RUN npm install --omit=dev
+
+COPY --chown=myuser . ./
+
+CMD ["node", "src/main.js"]

package/apify-actor/README.md

@@ -0,0 +1,166 @@
+# UCP Profile Validator
+
+Validate any merchant's **Universal Commerce Protocol (UCP)** business profile and check if their store is ready for AI-powered commerce agents.
+
+## What does UCP Profile Validator do?
+
+This Actor fetches and validates UCP business profiles published at `/.well-known/ucp`. It checks compliance with the [official UCP specification](https://ucp.dev/specification/overview/) and provides:
+
+- **Instant A-F grading** based on compliance score (0-100)
+- **Detailed issue reports** with error codes and severity levels
+- **Actionable fix recommendations** for each problem found
+- **UCP version detection** to ensure you're using the latest spec
+
+## What is UCP?
+
+The [Universal Commerce Protocol](https://ucp.dev) is an open standard developed by Google, Shopify, and other industry leaders. It enables AI shopping agents to:
+
+- Discover online stores programmatically
+- Understand store capabilities (checkout, orders, fulfillment)
+- Transact securely with proper authentication
+
+Merchants publish their UCP profile at `https://yourdomain.com/.well-known/ucp` to participate in AI-powered commerce.
+
+## Why validate your UCP profile?
+
+- **AI agents can't find you**: Invalid profiles mean AI shopping assistants skip your store
+- **Lost sales**: Customers using AI tools won't be able to purchase from you
+- **Compliance issues**: Incorrect schemas break integrations with payment and fulfillment systems
+- **Competitive disadvantage**: Early UCP adopters capture AI-driven traffic first
+
+## How to use UCP Profile Validator
+
+1. Enter the domain you want to validate (e.g., `mystore.com`)
+2. Select validation mode (Full recommended for comprehensive checks)
+3. Click **Run**
+4. Review the grade, issues, and recommendations in the output
+
+### Input options
+
+| Field | Description | Default |
+|-------|-------------|---------|
+| `domain` | Merchant domain to validate | Required |
+| `mode` | `full` (comprehensive) or `quick` (structural only) | `full` |
+| `includeRecommendations` | Add fix suggestions to output | `true` |
+
+## Validation checks performed
+
+| Check | Severity | Description |
+|-------|----------|-------------|
+| Profile accessibility | Error | Can we reach `/.well-known/ucp`? |
+| JSON structure | Error | Valid JSON with required `ucp` object |
+| Version format | Error | Must be `YYYY-MM-DD` format |
+| Services defined | Error | At least one service with transport binding |
+| Capabilities array | Error | Required capabilities with name/version/spec/schema |
+| HTTPS endpoints | Error | All endpoints must use HTTPS |
+| Namespace validation | Error | `dev.ucp.*` must use `ucp.dev` URLs |
+| Extension chains | Error | Parent capabilities must exist |
+| Signing keys | Error | Required if Order capability is present |
+| Trailing slashes | Warning | Endpoints should not have trailing `/` |
+
+## Output example
+
+```json
+{
+  "domain": "example.com",
+  "profileUrl": "https://example.com/.well-known/ucp",
+  "valid": false,
+  "score": 60,
+  "grade": "D",
+  "ucpVersion": "2026-01-11",
+  "errors": 2,
+  "warnings": 1,
+  "issues": [
+    {
+      "severity": "error",
+      "code": "UCP_NS_MISMATCH",
+      "message": "dev.ucp.* spec must be on ucp.dev"
+    },
+    {
+      "severity": "error",
+      "code": "UCP_MISSING_KEYS",
+      "message": "Order requires signing_keys"
+    },
+    {
+      "severity": "warn",
+      "code": "UCP_TRAILING_SLASH",
+      "message": "Remove trailing slash"
+    }
+  ],
+  "recommendations": [
+    "Fix all errors before deploying",
+    "Add signing_keys for Order capability"
+  ],
+  "checkedAt": "2026-01-14T12:00:00.000Z",
+  "generatorUrl": "https://ucptools.dev/generate"
+}
+```
+
+## Grading system
+
+| Grade | Score | Meaning |
+|-------|-------|---------|
+| **A** | 90-100 | Fully compliant, ready for AI agents |
+| **B** | 80-89 | Minor issues, mostly ready |
+| **C** | 70-79 | Several issues to fix |
+| **D** | 60-69 | Significant problems |
+| **F** | 0-59 | Profile broken or missing |
+
+## How much does it cost?
+
+This Actor uses **pay-per-event pricing**:
+
+- **$0.001 - $0.002 per validation** (tiered pricing for higher volumes)
+- Platform compute costs are included
+- No monthly fees or subscriptions
+
+| Tier | Price per 1,000 validations |
+|------|----------------------------|
+| Free | $2.00 |
+| Gold+ | $1.00 |
+
+Example: Validating 100 domains costs approximately $0.10 - $0.20.
+
+## Use cases
+
+- **Pre-launch validation**: Check your profile before going live with AI commerce
+- **Competitor analysis**: See which stores in your industry are UCP-ready
+- **Bulk monitoring**: Validate hundreds of domains programmatically via API
+- **Agency audits**: Check all client stores at once with scheduled runs
+- **CI/CD integration**: Add validation to your deployment pipeline
+
+## API integration
+
+```bash
+curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~ucp-profile-validator/runs" \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer YOUR_API_TOKEN" \
+  -d '{"domain": "example.com"}'
+```
+
+## Tips for fixing UCP issues
+
+1. **Start with errors first** - Warnings won't block AI agents, but errors will
+2. **Use the generator** - Visit [ucptools.dev/generate](https://ucptools.dev/generate) to create a valid profile from scratch
+3. **Test locally** - Use Quick mode during development for faster iteration
+4. **Check namespace rules** - Official `dev.ucp.*` capabilities must reference `ucp.dev` URLs
+
+## Need to generate a profile?
+
+If your store doesn't have a UCP profile yet, use our free generator:
+**[https://ucptools.dev/generate](https://ucptools.dev/generate)**
+
+## Resources
+
+- [UCP Specification](https://ucp.dev/specification/overview/)
+- [UCP GitHub Repository](https://github.com/Universal-Commerce-Protocol/ucp)
+- [Google UCP Business Profile Guide](https://developers.google.com/merchant/ucp/guides/business-profile)
+
+## Support
+
+- **Website**: [ucptools.dev](https://ucptools.dev)
+- **Email**: hello@ucptools.dev
+
+---
+
+**UCP.tools** - Get ready for AI commerce.