[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79GMS2GRB16A51DZXR7M1BC":3,"skill-same:01M79GMS2GRB16A51DZXR7M1BC":68},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":41,"commitSha":42,"skillDirectory":43,"forksCount":14,"repositoryHtmlUrl":44,"repositoryHomepageUrl":6,"ownerHtmlUrl":45,"ownerBlogUrl":6,"ownerDescription":46,"updatedAt":47,"install":48,"resources":61},"01M79GMS2GRB16A51DZXR7M1BC","vercel-firewall",null,"Vercel Firewall and security expert guidance. Use when configuring DDoS protection, WAF rules, rate limiting, bot filtering, IP allow\u002Fblock lists, OWASP rulesets, Attack Challenge Mode, or any security configuration on the Vercel platform.","zfifteen\u002Fskills-catalog","zfifteen","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F221906715?v=4","01M79CQFXDZM5J5CJTCECPFA66","Dionisio Alberto Lopez III","01M79CQFY4C62PN8A2T5KDAHGA",1,"MIT","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fvercel-firewall\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: vercel-firewall\ndescription: Vercel Firewall and security expert guidance. Use when configuring DDoS protection, WAF rules, rate limiting, bot filtering, IP allow\u002Fblock lists, OWASP rulesets, Attack Challenge Mode, or any security configuration on the Vercel platform.\nmetadata:\n  priority: 5\n  docs:\n    - \"https:\u002F\u002Fvercel.com\u002Fdocs\u002Fsecurity\u002Fvercel-firewall\"\n  sitemap: \"https:\u002F\u002Fvercel.com\u002Fsitemap\u002Fdocs.xml\"\n  pathPatterns:\n    - '.vercel\u002Ffirewall\u002F**'\n  bashPatterns:\n    - '\\bvercel\\s+firewall\\b'\n  promptSignals:\n    phrases:\n      - 'rate limit'\n      - 'rate limiting'\n      - 'firewall'\n      - 'WAF'\n      - 'DDoS protection'\n    minScore: 6\n---\n\n# Vercel Firewall\n\nYou are an expert in the Vercel Firewall — a multi-layered security solution with automatic DDoS protection, a customizable Web Application Firewall (WAF), bot management, and rate limiting.\n\n## Architecture & Rule Execution Order\n\n1. DDoS mitigation rules (automatic, platform-wide)\n2. WAF IP blocking rules\n3. WAF custom rules (in priority order)\n4. WAF Managed Rulesets (OWASP, Bot Protection, AI Bots)\n\nChanges propagate globally in under **300ms**. No redeployment required.\n\n## DDoS Protection (Automatic, All Plans)\n\n- Layer 3\u002F4 mitigation (automatic, always on)\n- Layer 7 protection (proprietary, tailored to web apps)\n- **Protectd**: Vercel's DoS mitigation infrastructure analyzes ~550K events\u002Fsec globally with median mitigation time of **2.5 seconds**\n- 40x faster detection with real-time stream processing\n- Handles 1B+ suspicious TCP connections per week\n- Proven to mitigate 1.37 Tbps attacks with zero downtime\n\nNo configuration needed — DDoS protection is always active.\n\n## WAF Custom Rules\n\n### Rule JSON Structure\n\n```json\n{\n  \"name\": \"Block WordPress scanners\",\n  \"description\": \"Block common WordPress probe paths\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        {\n          \"type\": \"path\",\n          \"op\": \"re\",\n          \"value\": \"^\u002Fwp-(admin|login|content|includes)\u002F\"\n        }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": {\n      \"action\": \"deny\"\n    }\n  }\n}\n```\n\n**Logic**: Each object in `conditionGroup` is an **OR** group. Conditions within a single group are **AND**ed. Multiple groups are **OR**ed.\n\n### Condition Types (25 available)\n\n| Type | Description | Extra Fields |\n|------|-------------|--------------|\n| `path` | URL path | |\n| `method` | HTTP method | |\n| `host` | Hostname | |\n| `ip_address` | Client IP (supports CIDR) | |\n| `user_agent` | User-Agent string | |\n| `header` | Request header value | `key` (header name) |\n| `query` | Query string parameter | `key` (param name) |\n| `cookie` | Cookie value | `key` (cookie name) |\n| `geo_country` | ISO country code (e.g., `US`) | |\n| `geo_continent` | Continent code (e.g., `NA`) | |\n| `geo_country_region` | State\u002Fprovince code | |\n| `geo_city` | City name | |\n| `geo_as_number` | ASN | |\n| `ja4_digest` | JA4 TLS fingerprint | |\n| `ja3_digest` | JA3 TLS fingerprint | |\n| `target_path` | Resolved path after routing | |\n| `route` | Matched route pattern | |\n| `raw_path` | Raw unparsed path | |\n| `region` | Vercel edge region code | |\n| `protocol` | http\u002Fhttps | |\n| `scheme` | URL scheme | |\n| `environment` | Deployment environment | |\n| `bot_name` | Specific bot name | |\n| `bot_category` | Bot category | |\n| `server_action` | Next.js Server Action ID | |\n\n### Condition Operators\n\n| Op | Meaning |\n|----|---------|\n| `eq` | Equals |\n| `neq` | Not equals |\n| `re` | Regex match |\n| `pre` | Starts with |\n| `suf` | Ends with |\n| `sub` | Contains |\n| `inc` | In array |\n| `ninc` | Not in array |\n| `ex` | Exists |\n| `nex` | Not exists |\n| `gt` \u002F `gte` | Greater than (or equal) |\n| `lt` \u002F `lte` | Less than (or equal) |\n\nAdditional optional fields: `neg: true` negates the condition, `key` required for `header`\u002F`query`\u002F`cookie` types.\n\n### Mitigation Actions\n\n| Action | Description |\n|--------|-------------|\n| `log` | Log only, allow traffic |\n| `deny` | Block request (403) |\n| `challenge` | JavaScript browser challenge |\n| `bypass` | Skip all subsequent WAF rules |\n| `rate_limit` | Apply rate limiting (requires `rateLimit` config) |\n| `redirect` | Redirect (requires `redirect` config) |\n\n### Persistent Actions\n\nBy default each request is evaluated individually. With **persistent actions**, rules are applied to all matching requests for a customizable duration (`actionDuration`), allowing the firewall to remember malicious behavior and block it earlier in the lifecycle.\n\n### Action Options\n\n```json\n{\n  \"action\": {\n    \"mitigate\": {\n      \"action\": \"deny\",\n      \"actionDuration\": \"1h\",\n      \"bypassSystem\": false,\n      \"logHeaders\": [\"user-agent\", \"x-forwarded-for\"],\n      \"redirect\": {\n        \"location\": \"https:\u002F\u002Fexample.com\u002Fblocked\",\n        \"permanent\": false\n      }\n    }\n  }\n}\n```\n\n## Practical Rule Examples\n\n### Block Sanctioned Countries\n\n```json\n{\n  \"name\": \"Block OFAC Sanctioned Countries\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        {\n          \"type\": \"geo_country\",\n          \"op\": \"inc\",\n          \"value\": [\"CU\", \"IR\", \"KP\", \"RU\", \"SY\"]\n        }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": { \"action\": \"deny\" }\n  }\n}\n```\n\n### Require API Key Header on \u002Fapi\u002F Routes\n\n```json\n{\n  \"name\": \"Require API Key\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        {\n          \"type\": \"header\",\n          \"op\": \"nex\",\n          \"key\": \"x-api-key\"\n        },\n        {\n          \"type\": \"path\",\n          \"op\": \"pre\",\n          \"value\": \"\u002Fapi\u002F\"\n        }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": { \"action\": \"deny\" }\n  }\n}\n```\n\n### Block by JA4 TLS Fingerprint\n\n```json\n{\n  \"name\": \"Block Known Malicious JA4\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        {\n          \"type\": \"ja4_digest\",\n          \"op\": \"eq\",\n          \"value\": \"t13d1516h2_8daaf6152771_b0da82dd1658\"\n        }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": { \"action\": \"deny\", \"actionDuration\": \"1h\" }\n  }\n}\n```\n\n### Block Datacenter ASNs\n\n```json\n{\n  \"name\": \"Block Known Datacenter ASNs\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        {\n          \"type\": \"geo_as_number\",\n          \"op\": \"inc\",\n          \"value\": [\"14618\", \"16509\", \"15169\"]\n        }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": { \"action\": \"deny\" }\n  }\n}\n```\n\n### Challenge cURL Requests\n\n```json\n{\n  \"name\": \"Challenge cURL\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        { \"type\": \"user_agent\", \"op\": \"re\", \"value\": \"^curl\u002F\" }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": { \"action\": \"challenge\" }\n  }\n}\n```\n\n## Rate Limiting\n\n### Rate Limit Rule\n\n```json\n{\n  \"name\": \"API Rate Limit - 100 req\u002Fmin\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        { \"type\": \"path\", \"op\": \"pre\", \"value\": \"\u002Fapi\u002F\" }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": {\n      \"action\": \"rate_limit\",\n      \"rateLimit\": {\n        \"algo\": \"fixed_window\",\n        \"window\": 60,\n        \"limit\": 100,\n        \"keys\": [\"ip\"],\n        \"action\": \"deny\"\n      }\n    }\n  }\n}\n```\n\n### Login Endpoint Protection\n\n```json\n{\n  \"name\": \"Login Rate Limit\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        { \"type\": \"path\", \"op\": \"eq\", \"value\": \"\u002Fapi\u002Fauth\u002Flogin\" },\n        { \"type\": \"method\", \"op\": \"eq\", \"value\": \"POST\" }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": {\n      \"action\": \"rate_limit\",\n      \"rateLimit\": {\n        \"algo\": \"fixed_window\",\n        \"window\": 60,\n        \"limit\": 10,\n        \"keys\": [\"ip\"],\n        \"action\": \"challenge\"\n      }\n    }\n  }\n}\n```\n\n### Rate Limit Configuration Options\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `algo` | string | `\"fixed_window\"` (all plans) or `\"token_bucket\"` (Enterprise) |\n| `window` | number | Seconds. Min 10, max 600 (Pro), max 3600 (Enterprise) |\n| `limit` | number | Max requests per window |\n| `keys` | array | Count per: `\"ip\"`, `\"ja4\"`, `\"user_agent\"`, custom headers (Enterprise) |\n| `action` | string | When exceeded: `\"deny\"`, `\"log\"`, `\"challenge\"` |\n\nWhen exceeded with `deny`, returns HTTP 429 with `X-RateLimit-Limit` and `X-RateLimit-Remaining` headers.\n\n## Bot Management\n\n### Bot Protection (GA — Free on All Plans)\n\nHeuristics-based detection that challenges non-browser bot traffic without disrupting verified webhook providers. Formerly \"Bot Filter\" during beta — renamed to Bot Protection at GA. Enable in log-only mode first to preview traffic impact:\n\n```json\n{\n  \"action\": \"managedRules.update\",\n  \"id\": \"bot_protection\",\n  \"value\": { \"active\": true, \"action\": \"challenge\" }\n}\n```\n\n> **Note**: The older `bot_filter` ID is deprecated. Use `bot_protection` in new configurations.\n\n### AI Bot Blocking\n\nBlock known AI crawlers (GPTBot, ClaudeBot, etc.):\n\n```json\n{\n  \"action\": \"managedRules.update\",\n  \"id\": \"ai_bots\",\n  \"value\": { \"active\": true, \"action\": \"deny\" }\n}\n```\n\n### Allow a Specific Bot (Bypass Rule)\n\nPlace this higher in priority than Bot Protection managed rules:\n\n```json\n{\n  \"name\": \"Allow My Monitoring Bot\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        { \"type\": \"user_agent\", \"op\": \"eq\", \"value\": \"MyMonitorBot\u002F1.0\" }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": { \"action\": \"bypass\" }\n  }\n}\n```\n\n### Enable BotID (Traffic Visibility)\n\n```json\n{ \"botIdEnabled\": true }\n```\n\n## IP Allow\u002FBlock Lists\n\n### Block an IP\n\n```json\n{\n  \"action\": \"ip.insert\",\n  \"value\": {\n    \"hostname\": \"my-site.com\",\n    \"ip\": \"203.0.113.45\",\n    \"action\": \"deny\",\n    \"notes\": \"Malicious scraper\"\n  }\n}\n```\n\n### Block a CIDR Range\n\n```json\n{\n  \"action\": \"ip.insert\",\n  \"value\": {\n    \"hostname\": \"my-site.com\",\n    \"ip\": \"203.0.113.0\u002F24\",\n    \"action\": \"deny\",\n    \"notes\": \"Bad actor CIDR block\"\n  }\n}\n```\n\n### Allow an IP (Bypass All Rules)\n\n```json\n{\n  \"action\": \"ip.insert\",\n  \"value\": {\n    \"hostname\": \"my-site.com\",\n    \"ip\": \"198.51.100.1\",\n    \"action\": \"bypass\",\n    \"notes\": \"Internal monitoring IP\"\n  }\n}\n```\n\n### IP Rule Actions\n\n| Action | Effect |\n|--------|--------|\n| `deny` | Block the IP |\n| `challenge` | Serve JS challenge |\n| `log` | Log traffic only |\n| `bypass` | Allow through all rules (allowlist) |\n\n**Note**: `hostname` must match the exact domain. Add separate entries per subdomain.\n\n## OWASP Core Ruleset (CRS)\n\n### Individual CRS Rules\n\n| ID | Protection |\n|----|-----------|\n| `sqli` | SQL Injection |\n| `xss` | Cross-Site Scripting |\n| `rce` | Remote Code Execution |\n| `lfi` | Local File Inclusion |\n| `rfi` | Remote File Inclusion |\n| `sd` | Scanner Detection |\n| `ma` | Multipart Attack |\n| `php` | PHP-specific exploits |\n| `gen` | Generic attack patterns |\n| `sf` | Session Fixation |\n| `java` | Java-specific exploits |\n\n### Enable OWASP Rules\n\n```json\n{\n  \"action\": \"crs.update\",\n  \"id\": \"sqli\",\n  \"value\": { \"active\": true, \"action\": \"deny\" }\n}\n```\n\n### Full OWASP + Bot Configuration (PUT)\n\n```json\n{\n  \"firewallEnabled\": true,\n  \"crs\": {\n    \"sqli\": { \"active\": true, \"action\": \"deny\" },\n    \"xss\": { \"active\": true, \"action\": \"deny\" },\n    \"rce\": { \"active\": true, \"action\": \"deny\" },\n    \"lfi\": { \"active\": true, \"action\": \"deny\" },\n    \"rfi\": { \"active\": true, \"action\": \"deny\" },\n    \"sd\": { \"active\": true, \"action\": \"log\" },\n    \"ma\": { \"active\": true, \"action\": \"deny\" },\n    \"gen\": { \"active\": true, \"action\": \"deny\" },\n    \"sf\": { \"active\": true, \"action\": \"deny\" },\n    \"php\": { \"active\": false, \"action\": \"log\" },\n    \"java\": { \"active\": false, \"action\": \"log\" }\n  },\n  \"managedRules\": {\n    \"owasp\": { \"active\": true, \"action\": \"deny\" },\n    \"bot_protection\": { \"active\": true, \"action\": \"challenge\" },\n    \"ai_bots\": { \"active\": true, \"action\": \"deny\" }\n  },\n  \"botIdEnabled\": true\n}\n```\n\n## Firewall REST API\n\nBase URL: `https:\u002F\u002Fapi.vercel.com`\nAuth: `Authorization: Bearer \u003CVERCEL_TOKEN>`\nQuery params: `?projectId=\u003Cid>&teamId=\u003Cid>`\n\n### Endpoints\n\n| Method | Path | Description |\n|--------|------|-------------|\n| `GET` | `\u002Fv1\u002Fsecurity\u002Ffirewall\u002Fconfig\u002Factive` | Read current config |\n| `PATCH` | `\u002Fv1\u002Fsecurity\u002Ffirewall\u002Fconfig` | Incremental update (add\u002Fremove\u002Fupdate rules) |\n| `PUT` | `\u002Fv1\u002Fsecurity\u002Ffirewall\u002Fconfig` | Full config replacement |\n| `POST` | `\u002Fv1\u002Fsecurity\u002Ffirewall\u002Fbypass` | Create temporary bypass rule |\n\n### PATCH Actions\n\n| Action | Description |\n|--------|-------------|\n| `firewallEnabled` | Enable\u002Fdisable firewall (value: boolean) |\n| `rules.insert` | Add a custom rule |\n| `rules.update` | Update rule (requires `id`) |\n| `rules.remove` | Delete rule (requires `id`) |\n| `rules.priority` | Reorder rule (requires `id`, value = index) |\n| `ip.insert` | Add IP rule |\n| `ip.update` | Update IP rule |\n| `ip.remove` | Delete IP rule |\n| `crs.update` | Enable\u002Fconfigure OWASP CRS rule |\n| `crs.disable` | Disable entire CRS |\n| `managedRules.update` | Configure managed ruleset |\n\n### Add a Rule via cURL\n\n```bash\ncurl -X PATCH \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fsecurity\u002Ffirewall\u002Fconfig?projectId=prj_xxx&teamId=team_xxx\" \\\n  -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"action\": \"rules.insert\",\n    \"value\": {\n      \"name\": \"Block WordPress scanners\",\n      \"active\": true,\n      \"conditionGroup\": [\n        {\n          \"conditions\": [\n            { \"type\": \"path\", \"op\": \"re\", \"value\": \"^\u002Fwp-(admin|login|content|includes)\u002F\" }\n          ]\n        }\n      ],\n      \"action\": { \"mitigate\": { \"action\": \"deny\" } }\n    }\n  }'\n```\n\n### Vercel SDK Usage\n\n```ts\nimport { Vercel } from '@vercel\u002Fsdk'\n\nconst vercel = new Vercel({ bearerToken: process.env.VERCEL_TOKEN })\n\n\u002F\u002F Read current firewall config\nconst config = await vercel.security.readFirewallConfig({\n  configVersion: 'active',\n  projectId: 'prj_xxx',\n  teamId: 'team_xxx',\n})\n\n\u002F\u002F Add a rule\nawait vercel.security.updateFirewallConfig({\n  projectId: 'prj_xxx',\n  teamId: 'team_xxx',\n  requestBody: {\n    action: 'rules.insert',\n    value: {\n      name: 'Rate limit API',\n      active: true,\n      conditionGroup: [\n        { conditions: [{ type: 'path', op: 'pre', value: '\u002Fapi\u002F' }] },\n      ],\n      action: {\n        mitigate: {\n          action: 'rate_limit',\n          rateLimit: { algo: 'fixed_window', window: 60, limit: 100, keys: ['ip'], action: 'deny' },\n        },\n      },\n    },\n  },\n})\n```\n\n### Create Temporary Bypass (Attack Challenge Mode)\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fsecurity\u002Ffirewall\u002Fbypass?projectId=prj_xxx&teamId=team_xxx\" \\\n  -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"domain\": \"my-site.com\",\n    \"sourceIp\": \"198.51.100.42\",\n    \"ttl\": 3600000,\n    \"note\": \"Temporary bypass for load testing\"\n  }'\n```\n\n## vercel.json WAF Rules\n\nDeclaratively define firewall rules in `vercel.json` using the `mitigate` key:\n\n```json\n{\n  \"$schema\": \"https:\u002F\u002Fopenapi.vercel.sh\u002Fvercel.json\",\n  \"routes\": [\n    {\n      \"src\": \"\u002Fapi\u002F(.*)\",\n      \"missing\": [\n        { \"type\": \"header\", \"key\": \"x-internal-token\" }\n      ],\n      \"mitigate\": { \"action\": \"deny\" }\n    },\n    {\n      \"src\": \"\u002F(.*)\",\n      \"has\": [\n        { \"type\": \"header\", \"key\": \"user-agent\", \"value\": \"(?i)^curl\u002F\" }\n      ],\n      \"mitigate\": { \"action\": \"challenge\" }\n    }\n  ]\n}\n```\n\nSupported actions in `vercel.json`: `\"challenge\"`, `\"deny\"` only. Rate limiting, `log`, and `bypass` require the Vercel Firewall dashboard at `https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Ffirewall` or the REST API.\n\n## Attack Challenge Mode\n\n- Available on all plans (free)\n- Shows browser verification challenge to all visitors during active attacks\n- Legitimate bots (Googlebot, webhook providers) automatically pass through\n- Internal Function-to-Function calls within the same account bypass automatically\n- Blocked requests don't count toward CDN\u002Ftraffic usage\n- Configured via dashboard only: open `https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Ffirewall` → **Bot Management** → **Attack Challenge Mode**\n\n## Plan Availability\n\n| Feature | Hobby | Pro | Enterprise |\n|---------|-------|-----|-----------|\n| DDoS Protection | All | All | All |\n| Custom Rules | 5 | 40 | 1000 |\n| Rate Limiting | 1 rule | 40 rules | 1000 rules |\n| Bot Protection (GA) | Yes | Yes | Yes |\n| OWASP CRS | — | — | Yes |\n| Token Bucket algo | — | — | Yes |\n| Custom rate limit keys | — | — | Yes |\n\n## Observability\n\n- Security event logs in the Firewall tab\n- **IP enrichment** — hover any IP in the Firewall dashboard to see ASN, location, and metadata\n- Create custom WAF rules directly from dashboard traffic charts (select \"Create Custom Rule\" from the actions menu)\n- Linkable to Monitoring queries for investigations\n- DDoS mitigation notifications (alerts on detection)\n- BotID traffic visibility when enabled\n\n## Official Documentation\n\n- [Vercel Firewall Overview](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall)\n- [Custom Rules](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Fvercel-waf\u002Fcustom-rules)\n- [Rate Limiting](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Fvercel-waf\u002Frate-limiting)\n- [IP Blocking](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Fvercel-waf\u002Fip-blocking)\n- [Managed Rulesets](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Fvercel-waf\u002Fmanaged-rulesets)\n- [Attack Challenge Mode](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Fattack-challenge-mode)\n- [Firewall API Guide](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Ffirewall-api)\n- [REST API Reference](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Ffirewall-api)\n","# Vercel Firewall\n\nYou are an expert in the Vercel Firewall — a multi-layered security solution with automatic DDoS protection, a customizable Web Application Firewall (WAF), bot management, and rate limiting.\n\n## Architecture & Rule Execution Order\n\n1. DDoS mitigation rules (automatic, platform-wide)\n2. WAF IP blocking rules\n3. WAF custom rules (in priority order)\n4. WAF Managed Rulesets (OWASP, Bot Protection, AI Bots)\n\nChanges propagate globally in under **300ms**. No redeployment required.\n\n## DDoS Protection (Automatic, All Plans)\n\n- Layer 3\u002F4 mitigation (automatic, always on)\n- Layer 7 protection (proprietary, tailored to web apps)\n- **Protectd**: Vercel's DoS mitigation infrastructure analyzes ~550K events\u002Fsec globally with median mitigation time of **2.5 seconds**\n- 40x faster detection with real-time stream processing\n- Handles 1B+ suspicious TCP connections per week\n- Proven to mitigate 1.37 Tbps attacks with zero downtime\n\nNo configuration needed — DDoS protection is always active.\n\n## WAF Custom Rules\n\n### Rule JSON Structure\n\n```json\n{\n  \"name\": \"Block WordPress scanners\",\n  \"description\": \"Block common WordPress probe paths\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        {\n          \"type\": \"path\",\n          \"op\": \"re\",\n          \"value\": \"^\u002Fwp-(admin|login|content|includes)\u002F\"\n        }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": {\n      \"action\": \"deny\"\n    }\n  }\n}\n```\n\n**Logic**: Each object in `conditionGroup` is an **OR** group. Conditions within a single group are **AND**ed. Multiple groups are **OR**ed.\n\n### Condition Types (25 available)\n\n| Type | Description | Extra Fields |\n|------|-------------|--------------|\n| `path` | URL path | |\n| `method` | HTTP method | |\n| `host` | Hostname | |\n| `ip_address` | Client IP (supports CIDR) | |\n| `user_agent` | User-Agent string | |\n| `header` | Request header value | `key` (header name) |\n| `query` | Query string parameter | `key` (param name) |\n| `cookie` | Cookie value | `key` (cookie name) |\n| `geo_country` | ISO country code (e.g., `US`) | |\n| `geo_continent` | Continent code (e.g., `NA`) | |\n| `geo_country_region` | State\u002Fprovince code | |\n| `geo_city` | City name | |\n| `geo_as_number` | ASN | |\n| `ja4_digest` | JA4 TLS fingerprint | |\n| `ja3_digest` | JA3 TLS fingerprint | |\n| `target_path` | Resolved path after routing | |\n| `route` | Matched route pattern | |\n| `raw_path` | Raw unparsed path | |\n| `region` | Vercel edge region code | |\n| `protocol` | http\u002Fhttps | |\n| `scheme` | URL scheme | |\n| `environment` | Deployment environment | |\n| `bot_name` | Specific bot name | |\n| `bot_category` | Bot category | |\n| `server_action` | Next.js Server Action ID | |\n\n### Condition Operators\n\n| Op | Meaning |\n|----|---------|\n| `eq` | Equals |\n| `neq` | Not equals |\n| `re` | Regex match |\n| `pre` | Starts with |\n| `suf` | Ends with |\n| `sub` | Contains |\n| `inc` | In array |\n| `ninc` | Not in array |\n| `ex` | Exists |\n| `nex` | Not exists |\n| `gt` \u002F `gte` | Greater than (or equal) |\n| `lt` \u002F `lte` | Less than (or equal) |\n\nAdditional optional fields: `neg: true` negates the condition, `key` required for `header`\u002F`query`\u002F`cookie` types.\n\n### Mitigation Actions\n\n| Action | Description |\n|--------|-------------|\n| `log` | Log only, allow traffic |\n| `deny` | Block request (403) |\n| `challenge` | JavaScript browser challenge |\n| `bypass` | Skip all subsequent WAF rules |\n| `rate_limit` | Apply rate limiting (requires `rateLimit` config) |\n| `redirect` | Redirect (requires `redirect` config) |\n\n### Persistent Actions\n\nBy default each request is evaluated individually. With **persistent actions**, rules are applied to all matching requests for a customizable duration (`actionDuration`), allowing the firewall to remember malicious behavior and block it earlier in the lifecycle.\n\n### Action Options\n\n```json\n{\n  \"action\": {\n    \"mitigate\": {\n      \"action\": \"deny\",\n      \"actionDuration\": \"1h\",\n      \"bypassSystem\": false,\n      \"logHeaders\": [\"user-agent\", \"x-forwarded-for\"],\n      \"redirect\": {\n        \"location\": \"https:\u002F\u002Fexample.com\u002Fblocked\",\n        \"permanent\": false\n      }\n    }\n  }\n}\n```\n\n## Practical Rule Examples\n\n### Block Sanctioned Countries\n\n```json\n{\n  \"name\": \"Block OFAC Sanctioned Countries\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        {\n          \"type\": \"geo_country\",\n          \"op\": \"inc\",\n          \"value\": [\"CU\", \"IR\", \"KP\", \"RU\", \"SY\"]\n        }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": { \"action\": \"deny\" }\n  }\n}\n```\n\n### Require API Key Header on \u002Fapi\u002F Routes\n\n```json\n{\n  \"name\": \"Require API Key\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        {\n          \"type\": \"header\",\n          \"op\": \"nex\",\n          \"key\": \"x-api-key\"\n        },\n        {\n          \"type\": \"path\",\n          \"op\": \"pre\",\n          \"value\": \"\u002Fapi\u002F\"\n        }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": { \"action\": \"deny\" }\n  }\n}\n```\n\n### Block by JA4 TLS Fingerprint\n\n```json\n{\n  \"name\": \"Block Known Malicious JA4\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        {\n          \"type\": \"ja4_digest\",\n          \"op\": \"eq\",\n          \"value\": \"t13d1516h2_8daaf6152771_b0da82dd1658\"\n        }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": { \"action\": \"deny\", \"actionDuration\": \"1h\" }\n  }\n}\n```\n\n### Block Datacenter ASNs\n\n```json\n{\n  \"name\": \"Block Known Datacenter ASNs\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        {\n          \"type\": \"geo_as_number\",\n          \"op\": \"inc\",\n          \"value\": [\"14618\", \"16509\", \"15169\"]\n        }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": { \"action\": \"deny\" }\n  }\n}\n```\n\n### Challenge cURL Requests\n\n```json\n{\n  \"name\": \"Challenge cURL\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        { \"type\": \"user_agent\", \"op\": \"re\", \"value\": \"^curl\u002F\" }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": { \"action\": \"challenge\" }\n  }\n}\n```\n\n## Rate Limiting\n\n### Rate Limit Rule\n\n```json\n{\n  \"name\": \"API Rate Limit - 100 req\u002Fmin\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        { \"type\": \"path\", \"op\": \"pre\", \"value\": \"\u002Fapi\u002F\" }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": {\n      \"action\": \"rate_limit\",\n      \"rateLimit\": {\n        \"algo\": \"fixed_window\",\n        \"window\": 60,\n        \"limit\": 100,\n        \"keys\": [\"ip\"],\n        \"action\": \"deny\"\n      }\n    }\n  }\n}\n```\n\n### Login Endpoint Protection\n\n```json\n{\n  \"name\": \"Login Rate Limit\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        { \"type\": \"path\", \"op\": \"eq\", \"value\": \"\u002Fapi\u002Fauth\u002Flogin\" },\n        { \"type\": \"method\", \"op\": \"eq\", \"value\": \"POST\" }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": {\n      \"action\": \"rate_limit\",\n      \"rateLimit\": {\n        \"algo\": \"fixed_window\",\n        \"window\": 60,\n        \"limit\": 10,\n        \"keys\": [\"ip\"],\n        \"action\": \"challenge\"\n      }\n    }\n  }\n}\n```\n\n### Rate Limit Configuration Options\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `algo` | string | `\"fixed_window\"` (all plans) or `\"token_bucket\"` (Enterprise) |\n| `window` | number | Seconds. Min 10, max 600 (Pro), max 3600 (Enterprise) |\n| `limit` | number | Max requests per window |\n| `keys` | array | Count per: `\"ip\"`, `\"ja4\"`, `\"user_agent\"`, custom headers (Enterprise) |\n| `action` | string | When exceeded: `\"deny\"`, `\"log\"`, `\"challenge\"` |\n\nWhen exceeded with `deny`, returns HTTP 429 with `X-RateLimit-Limit` and `X-RateLimit-Remaining` headers.\n\n## Bot Management\n\n### Bot Protection (GA — Free on All Plans)\n\nHeuristics-based detection that challenges non-browser bot traffic without disrupting verified webhook providers. Formerly \"Bot Filter\" during beta — renamed to Bot Protection at GA. Enable in log-only mode first to preview traffic impact:\n\n```json\n{\n  \"action\": \"managedRules.update\",\n  \"id\": \"bot_protection\",\n  \"value\": { \"active\": true, \"action\": \"challenge\" }\n}\n```\n\n> **Note**: The older `bot_filter` ID is deprecated. Use `bot_protection` in new configurations.\n\n### AI Bot Blocking\n\nBlock known AI crawlers (GPTBot, ClaudeBot, etc.):\n\n```json\n{\n  \"action\": \"managedRules.update\",\n  \"id\": \"ai_bots\",\n  \"value\": { \"active\": true, \"action\": \"deny\" }\n}\n```\n\n### Allow a Specific Bot (Bypass Rule)\n\nPlace this higher in priority than Bot Protection managed rules:\n\n```json\n{\n  \"name\": \"Allow My Monitoring Bot\",\n  \"active\": true,\n  \"conditionGroup\": [\n    {\n      \"conditions\": [\n        { \"type\": \"user_agent\", \"op\": \"eq\", \"value\": \"MyMonitorBot\u002F1.0\" }\n      ]\n    }\n  ],\n  \"action\": {\n    \"mitigate\": { \"action\": \"bypass\" }\n  }\n}\n```\n\n### Enable BotID (Traffic Visibility)\n\n```json\n{ \"botIdEnabled\": true }\n```\n\n## IP Allow\u002FBlock Lists\n\n### Block an IP\n\n```json\n{\n  \"action\": \"ip.insert\",\n  \"value\": {\n    \"hostname\": \"my-site.com\",\n    \"ip\": \"203.0.113.45\",\n    \"action\": \"deny\",\n    \"notes\": \"Malicious scraper\"\n  }\n}\n```\n\n### Block a CIDR Range\n\n```json\n{\n  \"action\": \"ip.insert\",\n  \"value\": {\n    \"hostname\": \"my-site.com\",\n    \"ip\": \"203.0.113.0\u002F24\",\n    \"action\": \"deny\",\n    \"notes\": \"Bad actor CIDR block\"\n  }\n}\n```\n\n### Allow an IP (Bypass All Rules)\n\n```json\n{\n  \"action\": \"ip.insert\",\n  \"value\": {\n    \"hostname\": \"my-site.com\",\n    \"ip\": \"198.51.100.1\",\n    \"action\": \"bypass\",\n    \"notes\": \"Internal monitoring IP\"\n  }\n}\n```\n\n### IP Rule Actions\n\n| Action | Effect |\n|--------|--------|\n| `deny` | Block the IP |\n| `challenge` | Serve JS challenge |\n| `log` | Log traffic only |\n| `bypass` | Allow through all rules (allowlist) |\n\n**Note**: `hostname` must match the exact domain. Add separate entries per subdomain.\n\n## OWASP Core Ruleset (CRS)\n\n### Individual CRS Rules\n\n| ID | Protection |\n|----|-----------|\n| `sqli` | SQL Injection |\n| `xss` | Cross-Site Scripting |\n| `rce` | Remote Code Execution |\n| `lfi` | Local File Inclusion |\n| `rfi` | Remote File Inclusion |\n| `sd` | Scanner Detection |\n| `ma` | Multipart Attack |\n| `php` | PHP-specific exploits |\n| `gen` | Generic attack patterns |\n| `sf` | Session Fixation |\n| `java` | Java-specific exploits |\n\n### Enable OWASP Rules\n\n```json\n{\n  \"action\": \"crs.update\",\n  \"id\": \"sqli\",\n  \"value\": { \"active\": true, \"action\": \"deny\" }\n}\n```\n\n### Full OWASP + Bot Configuration (PUT)\n\n```json\n{\n  \"firewallEnabled\": true,\n  \"crs\": {\n    \"sqli\": { \"active\": true, \"action\": \"deny\" },\n    \"xss\": { \"active\": true, \"action\": \"deny\" },\n    \"rce\": { \"active\": true, \"action\": \"deny\" },\n    \"lfi\": { \"active\": true, \"action\": \"deny\" },\n    \"rfi\": { \"active\": true, \"action\": \"deny\" },\n    \"sd\": { \"active\": true, \"action\": \"log\" },\n    \"ma\": { \"active\": true, \"action\": \"deny\" },\n    \"gen\": { \"active\": true, \"action\": \"deny\" },\n    \"sf\": { \"active\": true, \"action\": \"deny\" },\n    \"php\": { \"active\": false, \"action\": \"log\" },\n    \"java\": { \"active\": false, \"action\": \"log\" }\n  },\n  \"managedRules\": {\n    \"owasp\": { \"active\": true, \"action\": \"deny\" },\n    \"bot_protection\": { \"active\": true, \"action\": \"challenge\" },\n    \"ai_bots\": { \"active\": true, \"action\": \"deny\" }\n  },\n  \"botIdEnabled\": true\n}\n```\n\n## Firewall REST API\n\nBase URL: `https:\u002F\u002Fapi.vercel.com`\nAuth: `Authorization: Bearer \u003CVERCEL_TOKEN>`\nQuery params: `?projectId=\u003Cid>&teamId=\u003Cid>`\n\n### Endpoints\n\n| Method | Path | Description |\n|--------|------|-------------|\n| `GET` | `\u002Fv1\u002Fsecurity\u002Ffirewall\u002Fconfig\u002Factive` | Read current config |\n| `PATCH` | `\u002Fv1\u002Fsecurity\u002Ffirewall\u002Fconfig` | Incremental update (add\u002Fremove\u002Fupdate rules) |\n| `PUT` | `\u002Fv1\u002Fsecurity\u002Ffirewall\u002Fconfig` | Full config replacement |\n| `POST` | `\u002Fv1\u002Fsecurity\u002Ffirewall\u002Fbypass` | Create temporary bypass rule |\n\n### PATCH Actions\n\n| Action | Description |\n|--------|-------------|\n| `firewallEnabled` | Enable\u002Fdisable firewall (value: boolean) |\n| `rules.insert` | Add a custom rule |\n| `rules.update` | Update rule (requires `id`) |\n| `rules.remove` | Delete rule (requires `id`) |\n| `rules.priority` | Reorder rule (requires `id`, value = index) |\n| `ip.insert` | Add IP rule |\n| `ip.update` | Update IP rule |\n| `ip.remove` | Delete IP rule |\n| `crs.update` | Enable\u002Fconfigure OWASP CRS rule |\n| `crs.disable` | Disable entire CRS |\n| `managedRules.update` | Configure managed ruleset |\n\n### Add a Rule via cURL\n\n```bash\ncurl -X PATCH \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fsecurity\u002Ffirewall\u002Fconfig?projectId=prj_xxx&teamId=team_xxx\" \\\n  -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"action\": \"rules.insert\",\n    \"value\": {\n      \"name\": \"Block WordPress scanners\",\n      \"active\": true,\n      \"conditionGroup\": [\n        {\n          \"conditions\": [\n            { \"type\": \"path\", \"op\": \"re\", \"value\": \"^\u002Fwp-(admin|login|content|includes)\u002F\" }\n          ]\n        }\n      ],\n      \"action\": { \"mitigate\": { \"action\": \"deny\" } }\n    }\n  }'\n```\n\n### Vercel SDK Usage\n\n```ts\nimport { Vercel } from '@vercel\u002Fsdk'\n\nconst vercel = new Vercel({ bearerToken: process.env.VERCEL_TOKEN })\n\n\u002F\u002F Read current firewall config\nconst config = await vercel.security.readFirewallConfig({\n  configVersion: 'active',\n  projectId: 'prj_xxx',\n  teamId: 'team_xxx',\n})\n\n\u002F\u002F Add a rule\nawait vercel.security.updateFirewallConfig({\n  projectId: 'prj_xxx',\n  teamId: 'team_xxx',\n  requestBody: {\n    action: 'rules.insert',\n    value: {\n      name: 'Rate limit API',\n      active: true,\n      conditionGroup: [\n        { conditions: [{ type: 'path', op: 'pre', value: '\u002Fapi\u002F' }] },\n      ],\n      action: {\n        mitigate: {\n          action: 'rate_limit',\n          rateLimit: { algo: 'fixed_window', window: 60, limit: 100, keys: ['ip'], action: 'deny' },\n        },\n      },\n    },\n  },\n})\n```\n\n### Create Temporary Bypass (Attack Challenge Mode)\n\n```bash\ncurl -X POST \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fsecurity\u002Ffirewall\u002Fbypass?projectId=prj_xxx&teamId=team_xxx\" \\\n  -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"domain\": \"my-site.com\",\n    \"sourceIp\": \"198.51.100.42\",\n    \"ttl\": 3600000,\n    \"note\": \"Temporary bypass for load testing\"\n  }'\n```\n\n## vercel.json WAF Rules\n\nDeclaratively define firewall rules in `vercel.json` using the `mitigate` key:\n\n```json\n{\n  \"$schema\": \"https:\u002F\u002Fopenapi.vercel.sh\u002Fvercel.json\",\n  \"routes\": [\n    {\n      \"src\": \"\u002Fapi\u002F(.*)\",\n      \"missing\": [\n        { \"type\": \"header\", \"key\": \"x-internal-token\" }\n      ],\n      \"mitigate\": { \"action\": \"deny\" }\n    },\n    {\n      \"src\": \"\u002F(.*)\",\n      \"has\": [\n        { \"type\": \"header\", \"key\": \"user-agent\", \"value\": \"(?i)^curl\u002F\" }\n      ],\n      \"mitigate\": { \"action\": \"challenge\" }\n    }\n  ]\n}\n```\n\nSupported actions in `vercel.json`: `\"challenge\"`, `\"deny\"` only. Rate limiting, `log`, and `bypass` require the Vercel Firewall dashboard at `https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Ffirewall` or the REST API.\n\n## Attack Challenge Mode\n\n- Available on all plans (free)\n- Shows browser verification challenge to all visitors during active attacks\n- Legitimate bots (Googlebot, webhook providers) automatically pass through\n- Internal Function-to-Function calls within the same account bypass automatically\n- Blocked requests don't count toward CDN\u002Ftraffic usage\n- Configured via dashboard only: open `https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Ffirewall` → **Bot Management** → **Attack Challenge Mode**\n\n## Plan Availability\n\n| Feature | Hobby | Pro | Enterprise |\n|---------|-------|-----|-----------|\n| DDoS Protection | All | All | All |\n| Custom Rules | 5 | 40 | 1000 |\n| Rate Limiting | 1 rule | 40 rules | 1000 rules |\n| Bot Protection (GA) | Yes | Yes | Yes |\n| OWASP CRS | — | — | Yes |\n| Token Bucket algo | — | — | Yes |\n| Custom rate limit keys | — | — | Yes |\n\n## Observability\n\n- Security event logs in the Firewall tab\n- **IP enrichment** — hover any IP in the Firewall dashboard to see ASN, location, and metadata\n- Create custom WAF rules directly from dashboard traffic charts (select \"Create Custom Rule\" from the actions menu)\n- Linkable to Monitoring queries for investigations\n- DDoS mitigation notifications (alerts on detection)\n- BotID traffic visibility when enabled\n\n## Official Documentation\n\n- [Vercel Firewall Overview](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall)\n- [Custom Rules](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Fvercel-waf\u002Fcustom-rules)\n- [Rate Limiting](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Fvercel-waf\u002Frate-limiting)\n- [IP Blocking](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Fvercel-waf\u002Fip-blocking)\n- [Managed Rulesets](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Fvercel-waf\u002Fmanaged-rulesets)\n- [Attack Challenge Mode](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Fattack-challenge-mode)\n- [Firewall API Guide](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Ffirewall-api)\n- [REST API Reference](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fvercel-firewall\u002Ffirewall-api)\n",{"name":5,"metadata":24,"description":7},{"docs":25,"sitemap":27,"priority":28,"bashPatterns":29,"pathPatterns":31,"promptSignals":33},[26],"https:\u002F\u002Fvercel.com\u002Fdocs\u002Fsecurity\u002Fvercel-firewall","https:\u002F\u002Fvercel.com\u002Fsitemap\u002Fdocs.xml",5,[30],"\\bvercel\\s+firewall\\b",[32],".vercel\u002Ffirewall\u002F**",{"phrases":34,"minScore":40},[35,36,37,38,39],"rate limit","rate limiting","firewall","WAF","DDoS protection",6,"main","d9535210da9af28aa76bca80de80355197e1b6d6","skills\u002Fvercel-firewall","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog","https:\u002F\u002Fgithub.com\u002Fzfifteen","I like to measure things.","2026-07-19 23:41:54",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add zfifteen\u002Fskills-catalog --skill vercel-firewall",{"tool":54,"command":55},"bunx","bunx skills add zfifteen\u002Fskills-catalog --skill vercel-firewall",{"tool":57,"command":58},"pnpm","pnpm dlx skills add zfifteen\u002Fskills-catalog --skill vercel-firewall","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fvercel-firewall\u002FSKILL.md",true,[62],{"path":63,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":66,"sourceHtmlUrl":67},"agents\u002Fopenai.yaml","REFERENCE","参考文档",113,"https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fvercel-firewall\u002Fagents\u002Fopenai.yaml",[69,76,83,90,99,106],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M79GXQ2PWPT2E4CJYHXVJ0YE","Zotero","Use Zotero Desktop from Codex to enable\u002Fprobe the local API, search a local Zotero library, list items\u002Fcollections\u002Ftags, export BibTeX, insert citation keys into LaTeX or Markdown drafts, read indexed full text when requested, and import BibTeX\u002FRIS records into Zotero through the connector server. Use when the user mentions Zotero, citations, references.bib, BibTeX export, local Zotero API, localhost:23119, or adding citations from a Zotero library.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fzotero\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M79GXN85NETKBE06865CWK6Z","zoom-apps-sdk","Use when using Apps SDK.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M79GXCYD7FGYS932J9N9RFFY","youtube","Obtain accurate, timestamped YouTube video transcripts (preferring manual captions over auto-generated) as the primary deliverable, then derive summaries, key claims, or notes from that transcript.  Use when the user provides a YouTube URL (or video ID) and wants the transcript, a faithful summary, key claims with attribution, timestamped notes, or \"what does this video actually say\".  The skill is transcript-first: never substitute metadata, title, description, or search snippets for the spoken content.  Triggers: \"youtube transcript\", \"get the transcript of this video\", \"summarize this youtube video\", \"what did they say in https:\u002F\u002Fyoutube.com\u002F...\", \"key claims from this talk\".","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyoutube\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":94,"licenseFileUrl":95,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":19},"01M79GX8EXHHYM566BKR7MS778","yeet","Publish local changes to GitHub by confirming scope, committing intentionally, pushing the branch, and opening a draft PR through the GitHub app from this plugin, with `gh` used only as a fallback where connector coverage is insufficient.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":19},"01M79GX2HFJPX84NMRE5VBTYX9","x-post-creator","Create X-ready post threads and co-located story packages from the active conversation or referenced project material. Use when the user says turn this into an X-post, \u002Fx-post, make this into an X thread, or wants plain-language social posts with supporting images saved to docs\u002Fx-posts\u002F[story-name]\u002F.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fx-post-creator\u002FSKILL.md",[],[],{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":19},"01M79GWXQT4HBT6QME6QSBZJFA","x-api","Search, read, and write X posts through the local X API MCP server (the same backend used by the Codex x-api skill). Use for searching X\u002Fx.com, reading threads and replies, creating lists, staging\u002Fpublishing posts for @alltheputs, finding high-visibility reply targets for research outreach, ingesting public context, or any request that mentions \u002Fx-api or \"search X\".","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fx-api\u002FSKILL.md",[],[]]