@meffecta/agent 1.0.1 → 1.0.2

package/engine.json

@@ -1,4 +1,4 @@
 {
-  "engineTag": "1.0.1",
-  "builtFrom": "e86fcdf452f5403ce1c90805c904048dacc0c6ae"
+  "engineTag": "1.0.2",
+  "builtFrom": "6a4ebd7751d2eaeaca8f2f28d699a171d162208b"
 }

package/lib/integrations.js

@@ -114,6 +114,24 @@ const INTEGRATIONS = {
     ],
   },
 
+  serper: {
+    title: "Google search results (Serper)",
+    gives:
+      "query-serp — who ranks for a query, People Also Ask, news with a time filter, places. Competitor and market research, and rank tracking over time",
+    needs: [
+      "A Serper account at serper.dev. The first 2,500 queries are free and need no card;",
+      "after that credits are bought up front. Every successful call spends one.",
+    ],
+    steps: [["meffecta-agent set-secret SERPER_API_KEY", "from the Serper dashboard"]],
+    more: [
+      "This reads Google's actual result list, which the built-in web search does not — it",
+      "returns a curated set with no positions and no time filter. Reach for this when the",
+      "question is what the SERP looks like; reach for the built-in one to look something up.",
+      "A research job should save each response into its memory directory and report the",
+      "change since last time: the snapshot is cheap, the series is the point.",
+    ],
+  },
+
   cloudflare: {
     title: "Cloudflare",
     gives: "cloudflare — DNS, cache purge, Pages deployments, certificate checks",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meffecta/agent",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Set up and operate a Meffecta Agent deployment — a self-hosted Claude Code job runner.",
   "type": "module",
   "bin": {

package/scripts/verify-credentials.mjs

@@ -146,6 +146,24 @@ async function checkAhrefs() {
     : fail("AHREFS_API_KEY", `domain-rating-free → ${status}`);
 }
 
+async function checkSerper() {
+  if (!env.SERPER_API_KEY) {
+    return skip("SERPER_API_KEY", "unset");
+  }
+  // Every successful call spends a credit, so this asks for the smallest thing there is.
+  // An exhausted allowance is a 400, not a bad key — worth telling apart in the output,
+  // since one needs a person to top up and the other needs a new key.
+  const { status, json } = await http("https://google.serper.dev/search", {
+    method: "POST",
+    headers: { "X-API-KEY": env.SERPER_API_KEY, "content-type": "application/json" },
+    body: JSON.stringify({ q: "example", num: 1 }),
+  });
+  if (status === 200) {
+    return ok("SERPER_API_KEY", `${json?.organic?.length ?? 0} organic results, ${json?.credits ?? "?"} credits/query`);
+  }
+  return fail("SERPER_API_KEY", json?.message ? `${json.message} (${status})` : `search → ${status}`);
+}
+
 async function checkCloudflare() {
   if (!env.CLOUDFLARE_API_KEY || !env.CLOUDFLARE_ACCOUNT_ID) {
     return skip("CLOUDFLARE", "CLOUDFLARE_API_KEY/ACCOUNT_ID not set");
@@ -521,6 +539,7 @@ const CHECKS = [
   ["SWEEPOS_POSTGRES_URL_READONLY", checkPostgres],
   ["POSTHOG", checkPosthog],
   ["AHREFS_API_KEY", checkAhrefs],
+  ["SERPER_API_KEY", checkSerper],
   ["CLOUDFLARE", checkCloudflare],
   ["ELEVENLABS_API_KEY", checkElevenlabs],
   ["GOOGLE_API_KEY (Places)", checkPlaces],