Horizon Standard

# With API key (programmatic access)
curl -X POST https://open-horizon.replit.app/api/analyze \
  -H "Content-Type: application/json" \
  -H "x-api-key: oh_live_YOUR_KEY_HERE" \
  -d '{"url": "https://example.com"}'

# Without key (browser / UI session)
curl -X POST /api/analyze \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "WebSite",
      "@id": "https://example.com/#website",
      "url": "https://example.com",
      "name": "Example Site",
      "description": "A brief, AI-readable description",
      "inLanguage": "en",
      "potentialAction": {
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://example.com/search?q={search_term_string}"
        },
        "query-input": "required name=search_term_string"
      }
    },
    {
      "@type": "WebPage",
      "@id": "https://example.com/page#webpage",
      "url": "https://example.com/page",
      "isPartOf": { "@id": "https://example.com/#website" },
      "name": "Page Title",
      "description": "Page-level description",
      "headline": "Primary H1 heading",
      "inLanguage": "en",
      "canonicalUrl": "https://example.com/page",
      "speakable": {
        "@type": "SpeakableSpecification",
        "cssSelector": ["h1", "h2", "p"]
      }
    }
  ]
}

# Python: Score a URL before deciding whether to crawl it
import requests

def horizon_score(url: str, api_key: str) -> dict:
    resp = requests.post(
        "https://open-horizon.replit.app/api/analyze",
        headers={
            "Content-Type": "application/json",
            "x-api-key": api_key,
        },
        json={"url": url},
        timeout=30,
    )
    resp.raise_for_status()
    return resp.json()

# In your agent loop:
result = horizon_score("https://stripe.com", api_key="oh_live_...")
if result["overallScore"] >= 70:
    # High-confidence crawl — use extractedMeta directly
    meta = result["extractedMeta"]
    title = meta["title"]
    description = meta["description"]
else:
    # Low score — fall back to full HTML parse
    pass

// Node.js / TypeScript agent integration
async function getHorizonPassport(url) {
  const res = await fetch("/api/analyze", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": process.env.HORIZON_API_KEY,
    },
    body: JSON.stringify({ url }),
  });

  const data = await res.json();

  return {
    score: data.overallScore,
    meta: data.extractedMeta,
    efficiency: data.tokenData,
    // Use agentView for agent-facing summaries
    agentSummary: data.agentView,
  };
}

# llms.txt — example for yourdomain.com
# This file declares AI agent access policies for this domain.

> Summary: SaaS platform for project management. Agent-friendly.
> Contact: agents@yourdomain.com
> License: CC-BY 4.0

## Permitted
- Crawl: /docs, /blog, /api-reference
- Cite: all public pages
- Index: yes

## Restricted
- Crawl: /admin, /dashboard, /account
- Login required: /app

## Horizon Passport
- JSON-LD at: /horizon-passport.json
- Schema version: 1.0