Claude-code-plugins-plus-skills webflow-cost-tuning

install
source · Clone the upstream repo
git clone https://github.com/jeremylongshore/claude-code-plugins-plus-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jeremylongshore/claude-code-plugins-plus-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/saas-packs/webflow-pack/skills/webflow-cost-tuning" ~/.claude/skills/jeremylongshore-claude-code-plugins-plus-skills-webflow-cost-tuning && rm -rf "$T"
manifest: plugins/saas-packs/webflow-pack/skills/webflow-cost-tuning/SKILL.md
source content

Webflow Cost Tuning

Overview

Optimize Webflow costs through smart plan selection, CDN-cached reads, bulk endpoint usage, and proactive API usage monitoring. The biggest lever: CDN-cached live item reads are free and unlimited — shift reads to the Content Delivery API.

Prerequisites

  • Access to Webflow dashboard (billing section)
  • Understanding of your integration's read/write patterns
  • webflow-api
    SDK configured

Webflow Pricing Context

Site Plans (affect API limits)

PlanMonthlyCMS ItemsRate LimitsKey for API
Starter$050 itemsStandardTesting only
Basic$182,000 itemsStandardSmall sites
CMS$2910,000 itemsStandardContent-heavy
Business$4910,000 itemsHigher limitsProduction apps
EnterpriseCustomUnlimitedCustom limitsHigh-volume

Ecommerce Plans (additional)

PlanMonthlyProductsTransaction Fee
Standard$425002%
Plus$841,0000%
Advanced$2353,0000%

Workspace Plans (affect developer access)

PlanMonthlySitesMembers
Starter$021
Core$28103
Growth$60Unlimited9
EnterpriseCustomUnlimitedUnlimited

Instructions

Strategy 1: Shift Reads to CDN (Free and Unlimited)

The single biggest cost reduction: use the Content Delivery API for reads.

// EXPENSIVE: Staged item reads count against rate limits
const { items } = await webflow.collections.items.listItems(collectionId);

// FREE: CDN-cached live item reads have no rate limits
const { items } = await webflow.collections.items.listItemsLive(collectionId);

For public-facing content (blogs, product pages, team members), always use live item endpoints. Only use staged endpoints when you need draft items.

Strategy 2: Bulk Endpoints (100x Fewer API Calls)

// EXPENSIVE: 1000 items = 1000 API calls
for (const item of items) {
  await webflow.collections.items.createItem(collectionId, { fieldData: item });
}

// CHEAP: 1000 items = 10 API calls (100 per batch)
for (let i = 0; i < items.length; i += 100) {
  await webflow.collections.items.createItemsBulk(collectionId, {
    items: items.slice(i, i + 100).map(item => ({ fieldData: item })),
  });
}

Strategy 3: Cache Collection Schemas

Collection schemas change rarely — cache them aggressively:

import { LRUCache } from "lru-cache";

const schemaCache = new LRUCache<string, any>({
  max: 50,
  ttl: 60 * 60 * 1000, // 1 hour — schemas change very rarely
});

async function getCollectionSchema(siteId: string) {
  const key = `schema:${siteId}`;
  let schema = schemaCache.get(key);

  if (!schema) {
    const { collections } = await webflow.collections.list(siteId);
    schema = collections;
    schemaCache.set(key, schema);
  }

  return schema;
}

Strategy 4: API Usage Monitoring

class WebflowUsageTracker {
  private calls = new Map<string, number>();
  private startTime = Date.now();

  track(operation: string) {
    const count = this.calls.get(operation) || 0;
    this.calls.set(operation, count + 1);
  }

  getReport() {
    const totalCalls = Array.from(this.calls.values()).reduce((a, b) => a + b, 0);
    const elapsedMinutes = (Date.now() - this.startTime) / 60000;
    const callsPerMinute = totalCalls / elapsedMinutes;

    return {
      totalCalls,
      callsPerMinute: callsPerMinute.toFixed(1),
      byOperation: Object.fromEntries(this.calls),
      topOperations: Array.from(this.calls.entries())
        .sort((a, b) => b[1] - a[1])
        .slice(0, 5),
    };
  }

  reset() {
    this.calls.clear();
    this.startTime = Date.now();
  }
}

const tracker = new WebflowUsageTracker();

// Wrap your client to auto-track
function trackedCall<T>(operation: string, fn: () => Promise<T>): Promise<T> {
  tracker.track(operation);
  return fn();
}

// Usage
const items = await trackedCall("listItemsLive", () =>
  webflow.collections.items.listItemsLive(collectionId)
);

// Periodic report
setInterval(() => {
  console.log("API Usage:", tracker.getReport());
  tracker.reset();
}, 60 * 60 * 1000); // Hourly

Strategy 5: Webhook-Driven Updates (Replace Polling)

// EXPENSIVE: Polling every minute = 1,440 calls/day per collection
setInterval(async () => {
  const { items } = await webflow.collections.items.listItems(collectionId);
  await processChanges(items);
}, 60 * 1000);

// CHEAP: Webhook-driven = only called when something changes
// Register webhook: collection_item_changed
// Your webhook handler:
app.post("/webhooks/webflow", async (req, res) => {
  const event = req.body;
  if (event.triggerType === "collection_item_changed") {
    await processChanges([event.payload]);
  }
  res.status(200).send();
});

Strategy 6: Plan Right-Sizing

// Estimate which plan you need based on usage
function recommendPlan(usage: {
  cmsItems: number;
  monthlyApiCalls: number;
  ecommerceProducts: number;
}) {
  // CMS items determine minimum site plan
  if (usage.cmsItems > 10000) return { site: "Enterprise", reason: "CMS item limit" };
  if (usage.cmsItems > 2000) return { site: "CMS or Business", reason: "CMS item limit" };
  if (usage.cmsItems > 50) return { site: "Basic", reason: "CMS item limit" };

  // High API volume may need higher rate limits
  if (usage.monthlyApiCalls > 100000) return { site: "Business+", reason: "Rate limits" };

  // Ecommerce products
  if (usage.ecommerceProducts > 1000) return { ecommerce: "Advanced", reason: "Product limit" };
  if (usage.ecommerceProducts > 500) return { ecommerce: "Plus", reason: "Product limit" };

  return { site: "Basic", reason: "Sufficient for usage" };
}

Cost Reduction Checklist

  • Read-heavy endpoints use
    listItemsLive
    (CDN, no rate limit)
  • Bulk endpoints used for multi-item operations
  • Collection schemas cached (1-hour TTL minimum)
  • Polling replaced with webhooks where possible
  • API usage tracked and monitored
  • Plan matches actual usage (not over-provisioned)
  • Unnecessary API calls eliminated (no redundant fetches)

Output

  • CDN-cached reads for published content (free, unlimited)
  • Bulk operations reducing API calls 100x
  • Schema caching eliminating redundant reads
  • Usage monitoring with operation-level tracking
  • Plan right-sizing recommendations

Error Handling

IssueCauseSolution
Unexpected rate limitsToo many staged readsSwitch to live item endpoints
High API call countNo cachingAdd LRU or Redis cache
CMS item limit exceededWrong planUpgrade plan or archive old items
Polling costsNo webhook setupImplement webhook-driven updates

Resources

Next Steps

For architecture patterns, see

webflow-reference-architecture
.