Apply production-ready FireCrawl SDK patterns for TypeScript and Python. Use when implementing FireCrawl integrations, refactoring SDK usage, or establishing team coding standards for FireCrawl. Trigger with phrases like "firecrawl SDK patterns", "firecrawl best practices", "firecrawl code patterns", "idiomatic firecrawl".
Generates production-ready FireCrawl SDK patterns for TypeScript and Python integrations.
/plugin marketplace add jeremylongshore/claude-code-plugins-plus-skills/plugin install firecrawl-pack@claude-code-plugins-plusThis skill is limited to using the following tools:
Production-ready patterns for FireCrawl SDK usage in TypeScript and Python.
firecrawl-install-auth setup// src/firecrawl/client.ts
import { FireCrawlClient } from '@firecrawl/sdk';
let instance: FireCrawlClient | null = null;
export function getFireCrawlClient(): FireCrawlClient {
if (!instance) {
instance = new FireCrawlClient({
apiKey: process.env.FIRECRAWL_API_KEY!,
// Additional options
});
}
return instance;
}
import { FireCrawlError } from '@firecrawl/sdk';
async function safeFireCrawlCall<T>(
operation: () => Promise<T>
): Promise<{ data: T | null; error: Error | null }> {
try {
const data = await operation();
return { data, error: null };
} catch (err) {
if (err instanceof FireCrawlError) {
console.error({
code: err.code,
message: err.message,
});
}
return { data: null, error: err as Error };
}
}
async function withRetry<T>(
operation: () => Promise<T>,
maxRetries = 3,
backoffMs = 1000
): Promise<T> {
for (let attempt = 1; attempt <= maxRetries; attempt++) {
try {
return await operation();
} catch (err) {
if (attempt === maxRetries) throw err;
const delay = backoffMs * Math.pow(2, attempt - 1);
await new Promise(r => setTimeout(r, delay));
}
}
throw new Error('Unreachable');
}
| Pattern | Use Case | Benefit |
|---|---|---|
| Safe wrapper | All API calls | Prevents uncaught exceptions |
| Retry logic | Transient failures | Improves reliability |
| Type guards | Response validation | Catches API changes |
| Logging | All operations | Debugging and monitoring |
const clients = new Map<string, FireCrawlClient>();
export function getClientForTenant(tenantId: string): FireCrawlClient {
if (!clients.has(tenantId)) {
const apiKey = getTenantApiKey(tenantId);
clients.set(tenantId, new FireCrawlClient({ apiKey }));
}
return clients.get(tenantId)!;
}
from contextlib import asynccontextmanager
from firecrawl import FireCrawlClient
@asynccontextmanager
async def get_firecrawl_client():
client = FireCrawlClient()
try:
yield client
finally:
await client.close()
import { z } from 'zod';
const firecrawlResponseSchema = z.object({
id: z.string(),
status: z.enum(['active', 'inactive']),
createdAt: z.string().datetime(),
});
Apply patterns in firecrawl-core-workflow-a for real-world usage.
Expert guidance for Next.js Cache Components and Partial Prerendering (PPR). **PROACTIVE ACTIVATION**: Use this skill automatically when working in Next.js projects that have `cacheComponents: true` in their next.config.ts/next.config.js. When this config is detected, proactively apply Cache Components patterns and best practices to all React Server Component implementations. **DETECTION**: At the start of a session in a Next.js project, check for `cacheComponents: true` in next.config. If enabled, this skill's patterns should guide all component authoring, data fetching, and caching decisions. **USE CASES**: Implementing 'use cache' directive, configuring cache lifetimes with cacheLife(), tagging cached data with cacheTag(), invalidating caches with updateTag()/revalidateTag(), optimizing static vs dynamic content boundaries, debugging cache issues, and reviewing Cache Component implementations.