Skip to content

Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥

Nick: fc claw

Nicolasf27c87d9cd73
diff --git a/apps/api/src/controllers/v1/fireclaw.ts b/apps/api/src/controllers/v1/fireclaw.ts
new file mode 100644
index 000000000..25fd50de1
--- /dev/null
+++ b/apps/api/src/controllers/v1/fireclaw.ts
@@ -0,0 +1,69 @@
+import { Response } from "express";
+import { RequestWithAuth } from "./types";
+import { billTeam } from "../../services/billing/credit_billing";
+import { getACUCTeam } from "../auth";
+import { RateLimiterMode } from "../../types";
+import { logger } from "../../lib/logger";
+
+const FIRECLAW_COST_PER_PLAY = 100;
+const MAX_PLAYS = 10;
+
+interface FireclawResponse {
+ success: true;
+ credits_billed: number;
+ plays: number;
+ remaining_credits: number;
+}
+
+interface FireclawErrorResponse {
+ success: false;
+ error: string;
+}
+
+export async function fireclawController(
+ req: RequestWithAuth<{}, undefined, { plays?: number }>,
+ res: Response<FireclawResponse | FireclawErrorResponse>,
+): Promise<void> {
+ const plays = Math.max(1, Math.min(MAX_PLAYS, Math.floor(Number(req.body?.plays) || 1)));
+ const totalCredits = plays * FIRECLAW_COST_PER_PLAY;
+
+ const chunk =
+ req.acuc ??
+ (await getACUCTeam(req.auth.team_id, false, false, RateLimiterMode.Scrape));
+
+ if (!chunk) {
+ res.status(404).json({ success: false, error: "Could not find team billing information." });
+ return;
+ }
+
+ if (chunk.remaining_credits < totalCredits) {
+ res.status(402).json({
+ success: false,
+ error: `Not enough credits. You need ${totalCredits} credits (${plays} play${plays > 1 ? "s" : ""} x ${FIRECLAW_COST_PER_PLAY}) but only have ${chunk.remaining_credits}.`,
+ });
+ return;
+ }
+
+ try {
+ await billTeam(
+ req.auth.team_id,
+ req.acuc?.sub_id ?? undefined,
+ totalCredits,
+ req.acuc?.api_key_id ?? null,
+ { endpoint: "fireclaw" },
+ );
+ } catch (error) {
+ logger.error(`Fireclaw billing failed for team ${req.auth.team_id}`, { error });
+ res.status(500).json({ success: false, error: "Failed to process billing. Please try again." });
+ return;
+ }
+
+ const updatedChunk = await getACUCTeam(req.auth.team_id, false, false, RateLimiterMode.Scrape);
+
+ res.json({
+ success: true,
+ credits_billed: totalCredits,
+ plays,
+ remaining_credits: updatedChunk?.remaining_credits ?? chunk.remaining_credits - totalCredits,
+ });
+}
diff --git a/apps/api/src/routes/v1.ts b/apps/api/src/routes/v1.ts
index f7bdf59c5..0d27d69c0 100644
--- a/apps/api/src/routes/v1.ts
+++ b/apps/api/src/routes/v1.ts
@@ -25,6 +25,7 @@ import { deepResearchController } from "../controllers/v1/deep-research";
import { deepResearchStatusController } from "../controllers/v1/deep-research-status";
import { tokenUsageController } from "../controllers/v1/token-usage";
import { ongoingCrawlsController } from "../controllers/v1/crawl-ongoing";
+import { fireclawController } from "../controllers/v1/fireclaw";
import {
authMiddleware,
checkCreditsMiddleware,
@@ -281,6 +282,13 @@ v1Router.delete(
// v1Router.get("/health/liveness", livenessController);
// v1Router.get("/health/readiness", readinessController);
+v1Router.post(
+ "/fireclaw",
+ authMiddleware(RateLimiterMode.Scrape),
+ checkCreditsMiddleware(100),
+ wrap(fireclawController),
+);
+
v1Router.get(
"/team/credit-usage",
authMiddleware(RateLimiterMode.CrawlStatus),
diff --git a/apps/api/src/services/billing/types.ts b/apps/api/src/services/billing/types.ts
index c318d602b..f7bda2750 100644
--- a/apps/api/src/services/billing/types.ts
+++ b/apps/api/src/services/billing/types.ts
@@ -5,6 +5,7 @@ export type BillingEndpoint =
| "crawl"
| "deep_research"
| "extract"
+ | "fireclaw"
| "llms_txt"
| "map"
| "scrape"