{
  "docs": "https://usefoil.com/docs/attribution",
  "note": "Foil adds values without a version change, so treat each value as an open string and handle values you don't recognize. For a kind with allValuesListed true, its values and patterns cover every value Foil sends today.",
  "kinds": {
    "actor": {
      "description": "The `actor` label says what type of client is behind the session.",
      "allValuesListed": true,
      "values": [
        {
          "value": "automation",
          "label": "Automation",
          "description": "A browser driven by automation software or a script."
        },
        {
          "value": "ai-agent",
          "label": "AI Agent",
          "description": "An AI agent acting for a person. Foil names it from the agent's verified signature, the token its user agent sends, its browser extension or app browser, or a hosted browser that runs only that agent."
        },
        {
          "value": "crawler",
          "label": "Crawler",
          "description": "A crawler, fetcher, monitor, or other bot that identifies itself in its user agent, or that connects from its operator's crawler or monitoring network. See [Crawlers that send a browser user agent](https://usefoil.com/docs/attribution#crawlers-that-send-a-browser-user-agent) and [Monitors and test devices named by their network](https://usefoil.com/docs/attribution#monitors-and-test-devices-named-by-their-network)."
        },
        {
          "value": "unknown",
          "label": "Unknown",
          "description": "A bot whose type Foil couldn't determine."
        }
      ]
    },
    "provider": {
      "description": "The `provider` label names the hosted browser, scraping service, or device farm the session ran in, when Foil recognizes it.",
      "allValuesListed": true,
      "values": [
        {
          "value": "meta-muse",
          "label": "Muse",
          "description": "Meta's Muse AI agent"
        },
        {
          "value": "instinct",
          "label": "Instinct",
          "description": "Instinct AI agent"
        },
        {
          "value": "dot",
          "label": "Dot",
          "description": "OpenAI's Dot agents"
        },
        {
          "value": "grok-bot",
          "label": "Grok Bot",
          "description": "xAI's Grok Bot agent"
        },
        {
          "value": "grok",
          "label": "Grok",
          "description": "xAI's Grok assistant, running a task in its headless browser"
        },
        {
          "value": "perplexity-computer",
          "label": "Perplexity Computer",
          "description": "Perplexity's Computer AI agent"
        },
        {
          "value": "hark",
          "label": "Hark",
          "description": "Hark AI agent"
        },
        {
          "value": "pally",
          "label": "Pally",
          "description": "Pally AI assistant"
        },
        {
          "value": "browser-use-cloud",
          "label": "Browser Use Cloud",
          "description": "Browser Use's cloud browser for AI agents"
        },
        {
          "value": "anchor",
          "label": "Anchor Browser",
          "description": "Cloud browser"
        },
        {
          "value": "boat",
          "label": "Boat",
          "description": "Cloud desktop for AI agents"
        },
        {
          "value": "browserbase",
          "label": "Browserbase",
          "description": "Cloud browser"
        },
        {
          "value": "browserless",
          "label": "Browserless",
          "description": "Cloud browser"
        },
        {
          "value": "driverdev",
          "label": "Driver.dev",
          "description": "Cloud browser, which Browser Cash also runs on"
        },
        {
          "value": "firebase-test-lab",
          "label": "Firebase Test Lab",
          "description": "Google's app testing devices, which also run Google Play's pre-launch reports"
        },
        {
          "value": "hyperbrowser",
          "label": "Hyperbrowser",
          "description": "Cloud browser"
        },
        {
          "value": "onkernel",
          "label": "Kernel",
          "description": "Cloud browser"
        },
        {
          "value": "notte",
          "label": "Notte",
          "description": "Cloud browser for AI agents"
        },
        {
          "value": "steel",
          "label": "Steel",
          "description": "Cloud browser"
        },
        {
          "value": "tilion",
          "label": "Tilion",
          "description": "Cloud browser for AI agents"
        },
        {
          "value": "tinyfish",
          "label": "TinyFish",
          "description": "Cloud browser for AI agents"
        },
        {
          "value": "apify",
          "label": "Apify",
          "description": "Scraping service"
        },
        {
          "value": "context-dev",
          "label": "Context.dev",
          "description": "Scraping service"
        },
        {
          "value": "firecrawl",
          "label": "Firecrawl",
          "description": "Scraping service"
        },
        {
          "value": "geonode",
          "label": "Geonode",
          "description": "Scraping service"
        },
        {
          "value": "scrape-do",
          "label": "Scrape.do",
          "description": "Scraping service"
        },
        {
          "value": "scrapfly",
          "label": "Scrapfly",
          "description": "Scraping service"
        },
        {
          "value": "scrapingbee",
          "label": "ScrapingBee",
          "description": "Scraping service"
        },
        {
          "value": "usestring",
          "label": "String",
          "description": "Scraping service"
        },
        {
          "value": "zenrows",
          "label": "ZenRows",
          "description": "Scraping service"
        },
        {
          "value": "zyte",
          "label": "Zyte",
          "description": "Scraping service"
        }
      ]
    },
    "tool": {
      "description": "The `tool` label names the automation framework or client library.",
      "allValuesListed": true,
      "values": [
        {
          "value": "playwright",
          "label": "Playwright",
          "description": "Playwright"
        },
        {
          "value": "puppeteer",
          "label": "Puppeteer",
          "description": "Puppeteer"
        },
        {
          "value": "selenium",
          "label": "Selenium",
          "description": "Selenium"
        },
        {
          "value": "patchright",
          "label": "Patchright",
          "description": "Patchright, a patched Playwright"
        },
        {
          "value": "undetected-chromedriver",
          "label": "Undetected Chromedriver",
          "description": "undetected-chromedriver"
        },
        {
          "value": "seleniumbase-uc",
          "label": "Seleniumbase Uc",
          "description": "SeleniumBase in undetected mode"
        },
        {
          "value": "nodriver",
          "label": "Nodriver",
          "description": "nodriver"
        },
        {
          "value": "camoufox",
          "label": "Camoufox",
          "description": "Camoufox"
        },
        {
          "value": "cypress",
          "label": "Cypress",
          "description": "Cypress"
        },
        {
          "value": "phantomjs",
          "label": "Phantomjs",
          "description": "PhantomJS"
        },
        {
          "value": "http-library",
          "label": "HTTP Library",
          "description": "An HTTP client library rather than a browser"
        },
        {
          "value": "selenium-like",
          "label": "Selenium-like Automation",
          "description": "Selenium-style automation that Foil couldn't attribute to one framework"
        },
        {
          "value": "webdriver-generic",
          "label": "WebDriver-like Automation",
          "description": "WebDriver automation that Foil couldn't attribute to one framework"
        }
      ]
    },
    "product": {
      "description": "The `product` label names the specific bot, agent, or product.",
      "allValuesListed": false,
      "values": []
    },
    "organization": {
      "description": "The `organization` label names the company that operates the client.",
      "allValuesListed": false,
      "values": []
    },
    "purpose": {
      "description": "The `purpose` label says why a crawler or fetcher is on your site.",
      "allValuesListed": true,
      "values": [
        {
          "value": "search-engine",
          "label": "Search Engine",
          "description": "Indexes pages for a search engine"
        },
        {
          "value": "ai-search",
          "label": "AI Search",
          "description": "Fetches pages to answer AI search queries"
        },
        {
          "value": "ai-data-scraper",
          "label": "AI Data Scraper",
          "description": "Collects pages to train AI models"
        },
        {
          "value": "general-crawler",
          "label": "General Crawler",
          "description": "Crawls the web for a general or unstated purpose"
        },
        {
          "value": "social-preview",
          "label": "Social Preview",
          "description": "Builds link previews for social and messaging apps"
        },
        {
          "value": "fetcher",
          "label": "Fetcher",
          "description": "Fetches a page or feed for an app or service"
        },
        {
          "value": "feed-reader",
          "label": "Feed Reader",
          "description": "Reads RSS and Atom feeds"
        },
        {
          "value": "monitoring",
          "label": "Monitoring",
          "description": "Checks uptime or performance"
        },
        {
          "value": "seo-tool",
          "label": "Seo Tool",
          "description": "Audits pages for search engine optimization"
        },
        {
          "value": "archive",
          "label": "Archive",
          "description": "Archives pages"
        },
        {
          "value": "developer-helper",
          "label": "Developer Helper",
          "description": "Fetches pages for developer tools, such as validators and link checkers"
        },
        {
          "value": "intelligence-gatherer",
          "label": "Intelligence Gatherer",
          "description": "Collects pages for market, brand, or advertising intelligence"
        },
        {
          "value": "security-scanner",
          "label": "Security Scanner",
          "description": "Scans pages for vulnerabilities"
        }
      ]
    },
    "environment": {
      "description": "The `environment` label describes the browser engine and where the browser runs.",
      "allValuesListed": true,
      "values": [
        {
          "value": "chromium",
          "label": "Chromium",
          "description": "Chromium browser engine"
        },
        {
          "value": "firefox",
          "label": "Firefox",
          "description": "Firefox browser engine"
        },
        {
          "value": "webkit",
          "label": "Webkit",
          "description": "WebKit browser engine"
        },
        {
          "value": "headless",
          "label": "Headless",
          "description": "A headless browser"
        },
        {
          "value": "cloud",
          "label": "Cloud",
          "description": "A browser hosted in a data center rather than on a person's device"
        },
        {
          "value": "cloud-browser",
          "label": "Cloud-hosted Browser",
          "description": "A browser hosted in a data center rather than on a person's device"
        },
        {
          "value": "mobile-device-farm",
          "label": "Mobile Device Farm",
          "description": "A real phone or tablet in a remote device farm"
        },
        {
          "value": "in-app-browser",
          "label": "In-App Browser",
          "description": "An app's built-in browser, such as the one Facebook or the Google app opens links in. See [Apps and browsers](https://usefoil.com/docs/attribution#apps-and-browsers)."
        },
        {
          "value": "user",
          "label": "User",
          "description": "A fetch that a person started, such as by asking an AI assistant to open a page"
        },
        {
          "value": "search",
          "label": "Search",
          "description": "A fetch for an AI search feature"
        }
      ],
      "patterns": [
        {
          "pattern": "<provider>-<image>",
          "description": "The hosted browser image Foil recognized, named after its [provider](https://usefoil.com/docs/attribution#provider), such as `browserbase-default`"
        }
      ]
    },
    "trust": {
      "description": "The `trust` label says whether the client's claimed identity holds up.",
      "allValuesListed": true,
      "values": [
        {
          "value": "verified",
          "label": "Verified",
          "description": "Foil verified the client's Web Bot Auth signature."
        },
        {
          "value": "spoofed-identity",
          "label": "Spoofed Identity",
          "description": "The request carried a Web Bot Auth signature that failed verification."
        },
        {
          "value": "fabricated",
          "label": "Fabricated",
          "description": "The collected browser data didn't come from a real browser running Foil."
        }
      ]
    },
    "evasion": {
      "description": "The `evasion` label says the client tried to hide that it is automated.",
      "allValuesListed": true,
      "values": [
        {
          "value": "stealth",
          "label": "Stealth",
          "description": "The browser hides signs of automation, for example with a stealth plugin."
        },
        {
          "value": "webdriver-masking",
          "label": "WebDriver Masking",
          "description": "The browser hides the WebDriver flag that automation sets."
        }
      ]
    }
  },
  "aiAgents": [
    {
      "agent": "Muse",
      "labels": [
        {
          "kind": "product",
          "value": "muse.ai"
        }
      ],
      "evidence": "Signature"
    },
    {
      "agent": "Muse",
      "labels": [
        {
          "kind": "provider",
          "value": "meta-muse"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Instinct",
      "labels": [
        {
          "kind": "provider",
          "value": "instinct"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Dot (OpenAI)",
      "labels": [
        {
          "kind": "product",
          "value": "chatgpt.com"
        }
      ],
      "evidence": "Signature"
    },
    {
      "agent": "Dot (OpenAI)",
      "labels": [
        {
          "kind": "provider",
          "value": "dot"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Dot (OpenAI)",
      "labels": [
        {
          "kind": "provider",
          "value": "chatgpt-agent"
        }
      ],
      "evidence": "Hosted browser, on sessions scored before October 29, 2026"
    },
    {
      "agent": "Grok Bot (xAI)",
      "labels": [
        {
          "kind": "product",
          "value": "cursorusercontent.com"
        }
      ],
      "evidence": "Signature"
    },
    {
      "agent": "Grok Bot (xAI)",
      "labels": [
        {
          "kind": "provider",
          "value": "grok-bot"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Grok (xAI)",
      "labels": [
        {
          "kind": "provider",
          "value": "grok"
        }
      ],
      "evidence": "Headless browser and its exit network"
    },
    {
      "agent": "Perplexity Computer",
      "labels": [
        {
          "kind": "provider",
          "value": "perplexity-computer"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Google-Agent",
      "labels": [
        {
          "kind": "product",
          "value": "google-agent"
        },
        {
          "kind": "product",
          "value": "agent.bot.goog"
        }
      ],
      "evidence": "Signature"
    },
    {
      "agent": "Google-Agent",
      "labels": [
        {
          "kind": "product",
          "value": "agent.bot.goog"
        },
        {
          "kind": "actor",
          "value": "ai-agent"
        }
      ],
      "evidence": "Signature"
    },
    {
      "agent": "Google-Agent",
      "labels": [
        {
          "kind": "product",
          "value": "google-agent"
        }
      ],
      "evidence": "User agent"
    },
    {
      "agent": "Google-Agent",
      "labels": [
        {
          "kind": "product",
          "value": "googleagent-mariner"
        }
      ],
      "evidence": "User agent"
    },
    {
      "agent": "Claude (Anthropic)",
      "labels": [
        {
          "kind": "product",
          "value": "claude-agent"
        }
      ],
      "evidence": "User agent"
    },
    {
      "agent": "Claude computer use",
      "labels": [
        {
          "kind": "product",
          "value": "claude-desktop-browser"
        }
      ],
      "evidence": "The Claude app's built-in browser"
    },
    {
      "agent": "Claude computer use",
      "labels": [
        {
          "kind": "product",
          "value": "claude-in-chrome"
        }
      ],
      "evidence": "Claude in Chrome"
    },
    {
      "agent": "Claude computer use",
      "labels": [
        {
          "kind": "product",
          "value": "claude-computer-use"
        }
      ],
      "evidence": "Claude in Chrome, on sessions scored before October 29, 2026"
    },
    {
      "agent": "ChatGPT computer use",
      "labels": [
        {
          "kind": "product",
          "value": "chatgpt-in-chrome"
        }
      ],
      "evidence": "ChatGPT's Chrome extension"
    },
    {
      "agent": "ChatGPT computer use",
      "labels": [
        {
          "kind": "product",
          "value": "chatgpt-in-app-browser"
        }
      ],
      "evidence": "The ChatGPT app's built-in browser"
    },
    {
      "agent": "Muse computer use",
      "labels": [
        {
          "kind": "product",
          "value": "muse-in-chrome"
        }
      ],
      "evidence": "Muse's Chrome extension"
    },
    {
      "agent": "Manus",
      "labels": [
        {
          "kind": "product",
          "value": "manus-user"
        }
      ],
      "evidence": "User agent"
    },
    {
      "agent": "Manus",
      "labels": [
        {
          "kind": "product",
          "value": "manus-desktop-browser"
        }
      ],
      "evidence": "The Manus app's built-in browser"
    },
    {
      "agent": "Manus",
      "labels": [
        {
          "kind": "product",
          "value": "manus-cloud-browser"
        }
      ],
      "evidence": "Manus's cloud browser"
    },
    {
      "agent": "Nova Act (Amazon)",
      "labels": [
        {
          "kind": "product",
          "value": "novaact"
        }
      ],
      "evidence": "User agent"
    },
    {
      "agent": "Buy for Me (Amazon)",
      "labels": [
        {
          "kind": "product",
          "value": "amazonbuyforme"
        }
      ],
      "evidence": "User agent"
    },
    {
      "agent": "AgentCore Browser (Amazon)",
      "labels": [
        {
          "kind": "product",
          "value": "amazon-bedrock-agentcore-browser"
        }
      ],
      "evidence": "User agent"
    },
    {
      "agent": "Twin",
      "labels": [
        {
          "kind": "product",
          "value": "twinagent"
        }
      ],
      "evidence": "User agent"
    },
    {
      "agent": "Hark",
      "labels": [
        {
          "kind": "provider",
          "value": "hark"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Pally",
      "labels": [
        {
          "kind": "provider",
          "value": "pally"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Browser Use",
      "labels": [
        {
          "kind": "provider",
          "value": "browser-use-cloud"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Cloudflare Browser Rendering",
      "labels": [
        {
          "kind": "product",
          "value": "web-bot-auth.cloudflare-browser-rendering-085.workers.dev"
        }
      ],
      "evidence": "Signature"
    },
    {
      "agent": "Cloudflare Browser Rendering",
      "labels": [
        {
          "kind": "product",
          "value": "cloudflare-browser-rendering"
        }
      ],
      "evidence": "User agent"
    },
    {
      "agent": "Anchor Browser",
      "labels": [
        {
          "kind": "product",
          "value": "anchor-browser"
        }
      ],
      "evidence": "User agent"
    },
    {
      "agent": "Anchor Browser",
      "labels": [
        {
          "kind": "provider",
          "value": "anchor"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Browserbase",
      "labels": [
        {
          "kind": "provider",
          "value": "browserbase"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Kernel",
      "labels": [
        {
          "kind": "provider",
          "value": "onkernel"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Steel",
      "labels": [
        {
          "kind": "provider",
          "value": "steel"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Hyperbrowser",
      "labels": [
        {
          "kind": "provider",
          "value": "hyperbrowser"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Browserless",
      "labels": [
        {
          "kind": "provider",
          "value": "browserless"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "TinyFish",
      "labels": [
        {
          "kind": "provider",
          "value": "tinyfish"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Tilion",
      "labels": [
        {
          "kind": "provider",
          "value": "tilion"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Notte",
      "labels": [
        {
          "kind": "provider",
          "value": "notte"
        }
      ],
      "evidence": "Hosted browser"
    },
    {
      "agent": "Driver.dev",
      "labels": [
        {
          "kind": "provider",
          "value": "driverdev"
        }
      ],
      "evidence": "Hosted browser and its exit network"
    },
    {
      "agent": "Boat",
      "labels": [
        {
          "kind": "provider",
          "value": "boat"
        }
      ],
      "evidence": "Hosted desktop"
    },
    {
      "agent": "Comet (Perplexity)",
      "labels": [
        {
          "kind": "product",
          "value": "comet"
        }
      ],
      "evidence": "Comet browser"
    },
    {
      "agent": "Aside",
      "labels": [
        {
          "kind": "product",
          "value": "aside"
        }
      ],
      "evidence": "Aside's bundled browser runtime"
    },
    {
      "agent": "Cursor",
      "labels": [
        {
          "kind": "product",
          "value": "cursor-browser"
        }
      ],
      "evidence": "Cursor's built-in browser"
    },
    {
      "agent": "Lovable",
      "labels": [
        {
          "kind": "product",
          "value": "lovable-browser"
        }
      ],
      "evidence": "The Lovable app's built-in browser"
    },
    {
      "agent": "Visual Studio Code",
      "labels": [
        {
          "kind": "product",
          "value": "vscode-browser"
        }
      ],
      "evidence": "Visual Studio Code's built-in browser"
    },
    {
      "agent": "Antigravity",
      "labels": [
        {
          "kind": "product",
          "value": "antigravity-browser"
        }
      ],
      "evidence": "Antigravity's built-in browser"
    },
    {
      "agent": "Abacus.AI Desktop",
      "labels": [
        {
          "kind": "product",
          "value": "abacus-ai-desktop-browser"
        }
      ],
      "evidence": "The Abacus.AI Desktop app's built-in browser"
    },
    {
      "agent": "T3 Code",
      "labels": [
        {
          "kind": "product",
          "value": "t3-code-browser"
        }
      ],
      "evidence": "The T3 Code app's built-in browser"
    },
    {
      "agent": "Paseo",
      "labels": [
        {
          "kind": "product",
          "value": "paseo-browser"
        }
      ],
      "evidence": "The Paseo app's built-in browser"
    },
    {
      "agent": "Intent",
      "labels": [
        {
          "kind": "product",
          "value": "intent-browser"
        }
      ],
      "evidence": "The Intent app's built-in browser"
    },
    {
      "agent": "ZCode",
      "labels": [
        {
          "kind": "product",
          "value": "zcode-browser"
        }
      ],
      "evidence": "The ZCode app's built-in browser"
    },
    {
      "agent": "OpenCode",
      "labels": [
        {
          "kind": "product",
          "value": "opencode-browser"
        }
      ],
      "evidence": "The OpenCode desktop app's built-in browser"
    },
    {
      "agent": "Hermes Agent",
      "labels": [
        {
          "kind": "product",
          "value": "hermes-browser"
        }
      ],
      "evidence": "The Hermes Agent app's built-in browser"
    },
    {
      "agent": "OpenChamber",
      "labels": [
        {
          "kind": "product",
          "value": "openchamber-browser"
        }
      ],
      "evidence": "The OpenChamber app's built-in browser"
    },
    {
      "agent": "Superset",
      "labels": [
        {
          "kind": "product",
          "value": "superset-browser"
        }
      ],
      "evidence": "The Superset app's built-in browser"
    },
    {
      "agent": "Orca",
      "labels": [
        {
          "kind": "product",
          "value": "orca-browser"
        }
      ],
      "evidence": "The Orca app's built-in browser"
    },
    {
      "agent": "Tenslo Code",
      "labels": [
        {
          "kind": "product",
          "value": "tenslo-code-browser"
        }
      ],
      "evidence": "The Tenslo Code app's built-in browser"
    }
  ]
}
