Flapbase

A workspace that grows with your business — services, products, creative work, development. Any kind of project.

Open source. Use it with your AI agents, from your own code, or in Flapbase Cloud. New tools arrive every week.

日本語

Site check

Check locally how search engines and AI read a site. Pass a public URL, a saved HTML file or a folder; you get what to fix, in order, with the reason. No account or API key. Node.js 22+, no external dependencies.

Problems to fix before publishing: 7
1. The publish folder contains .env (1 page: .env). Fix: Remove .env from the publish folder.
2. An HTTPS page loads an HTTP resource (1 page: index.html). Fix: Use HTTPS for the resource URL.

git clone https://github.com/Flapbase/flapbase.git
cd flapbase
node bin/flap.js check examples/travel-broken

The npm package is @flapbase/cli and the command is flap. Once published to npm:

npx --yes @flapbase/[email protected] check https://flapbase.com
npx --yes @flapbase/[email protected] check ./site --json

What it checks

• The 11 basics: doctype, language, charset, mobile viewport, title, description, canonical URL, main heading, structured data (JSON-LD), content in the initial HTML, noindex.
• How AI reads the site: robots.txt, search, answer and training crawlers, organization structured data, responses per language, sitemap.
• Facts in the initial HTML: price, service area and booking method, from text, headings and JSON-LD. Choose them with --facts price,area,booking.
• Booking, contact and purchase links and forms, including mobile menus: source, label and final destination. URL checks follow redirects; folder checks resolve local files.
• Prices in yen, opening days, addresses and phone numbers across pages, languages and JSON-LD.
• Publication accidents: .env, .git, private key files and HTTP resources on HTTPS pages.
• Problems grouped by rule and cause, with affected pages, evidence and where to fix them. --baseline separates fixed, new and continuing problems.
• --json returns the same result as JSON. The text output is built from it.

node bin/flap.js check https://flapbase.com --json
node bin/flap.js check examples/apparel/index.html
node bin/flap.js check examples/travel --base-url https://example.com/travel/

Save a result, make changes and check again:

node bin/flap.js check ./site --json > /tmp/site-before.json
node bin/flap.js check ./site --baseline /tmp/site-before.json
node bin/flap.js check ./site --facts price,booking --json

For a file, robots.txt and the sitemap are read from the same folder; for a folder, from its root. No URL is fetched in that case. Anything that could not be read is reported as "unchecked". The exit code is 0 even when fixes are found, and 1 when the input or a fetch fails.

URL fetching is limited to public HTTPS sites; private networks and local devices are refused. Limits: HTML 1 MiB and 10 s, robots.txt 64 KiB, sitemap 256 KiB, 3 redirects. Folders: up to 100 HTML files, 8 MiB in total, depth 8.

Flapbase

Flapbase is a workspace for growing your business. This repository opens it so anyone can run it locally.

• Developers can use it directly in their own projects.
• AI agents such as Claude Code and Codex (ChatGPT) can use it in a few steps.
• Prefer a visual interface? Use Flapbase Cloud. The results are the same.

Use from AI agents

Install the skills in Claude Code, Codex (ChatGPT) and other agents with one line:

npx skills add Flapbase/flapbase

Skills are grouped by what you are trying to do. Within a group, use them top to bottom.

Understand the business

Skill	What it does
flapbase-acquisition-check	Lays out ad spend, visits, inquiries, deals and sales, shows where people drop off and what each lead costs
flapbase-business-profile-check	Checks the business profile and service list, and rewrites the profile so it earns trust and inquiries
flapbase-ai-adoption	Starts using chat AI at work: which tasks to hand off, prompt templates, and what not to put into AI
flapbase-business-map	Answers "what should we fix now?" by picking one question and only the analyses it needs, with evidence marked as observed, external, estimated or hypothesis
flapbase-measures-inventory	Takes stock of your marketing as audience × action × tool, without forms, and finds what to add, fix, tidy or stop

Site and AI visibility (in order)

Skill	What it does
flapbase-site-check	1. Runs the site check locally and explains the fixes
flapbase-site-diagnosis	2. Checks the content: what an AI needs to recommend the site
flapbase-ai-visibility	3. Checks every week whether AI assistants name the business correctly, and which comparison searches and lists matter
flapbase-mail-check	Checks whether email to customers is set up to arrive (SPF, DKIM, DMARC) from public DNS, and gives the values to enter
flapbase-site-migrate	Moves an existing site (HTML, React, Astro, WordPress export) into Flap Site

Publishing

This is the beginning of the README. Read the rest at the original. Read the full README ↗