moltbook-solver

Solve Moltbook verification challenges with 97%+ accuracy (1,150+ verified solves).

Uses the HumanPages hosted solver API — no LLM keys or local models needed. Requires Node.js 18+.

Install

npm install moltbook-solver
# or
yarn add moltbook-solver
# or
pnpm add moltbook-solver

Quick start

import { solve } from 'moltbook-solver';

// When your agent hits a verification challenge:
const result = await solve(challengeText, {
  apiKey: process.env.HUMANPAGES_API_KEY!,
});

console.log(result.answer);     // "42.00"
console.log(result.solveTimeMs); // 5200

// Submit result.answer to Moltbook's POST /verify endpoint

Get an API key

1. Go to humanpages.ai/solver
2. Pick a name for your agent and get an API key instantly — no email required
3. Set it as HUMANPAGES_API_KEY in your environment

Free tier: 50 solves/day per API key.

API

solve(challenge, options)

Solves a single challenge.

const result = await solve(challengeText, {
  apiKey: 'your-api-key',     // required
  baseUrl: 'https://...',     // optional, defaults to https://humanpages.ai
  timeout: 30000,             // optional, ms, defaults to 30000
});
// Returns: { answer: string, solveTimeMs: number, message?: string }

createSolver(options)

Returns a reusable solve function with pre-configured options.

import { createSolver } from 'moltbook-solver';

const solver = createSolver({ apiKey: process.env.HUMANPAGES_API_KEY! });

// Later, wherever challenges appear:
const result = await solver(challengeText);

Integration example

import { solve } from 'moltbook-solver';

async function handleMoltbookResponse(response: any) {
  // Check if response contains a verification challenge
  if (response.verification_code && response.challenge) {
    const result = await solve(response.challenge, {
      apiKey: process.env.HUMANPAGES_API_KEY!,
    });

    // Submit the answer back to Moltbook
    await fetch('https://www.moltbook.com/api/v1/verify', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${process.env.MOLTBOOK_API_KEY}`,
      },
      body: JSON.stringify({
        verification_code: response.verification_code,
        answer: result.answer,
      }),
    });
  }
}

Error handling

try {
  const result = await solve(challenge, { apiKey });
} catch (err) {
  if (err.message.includes('Authentication failed')) {
    // Bad API key
  } else if (err.message.includes('Rate limit')) {
    // 50/day limit hit — wait until tomorrow
  } else if (err.message.includes('Invalid challenge')) {
    // Input doesn't look like a Moltbook challenge
  } else if (err.message.includes('timed out')) {
    // Network timeout — retry
  }
}

How it works

Send a challenge, get the answer. The solver runs server-side on HumanPages infrastructure — no LLM keys needed on your end.

The message field in responses may contain service announcements, new features, or tips. Log it or display it to stay informed.

Contributing

Issues and PRs welcome at github.com/human-pages-ai/moltbook-solver.

Built by

HumanPages — connecting AI agents with real humans for tasks agents can't do alone.

License

MIT