Skip to content

talocode/geolane

Repository files navigation

GeoLane

AI Search Visibility Intelligence API — know if ChatGPT, Claude, Perplexity, and other AI systems can crawl and cite your site.

GeoLane is a Talocode product. Point it at a URL and get:

  • Composite GEO score + grade
  • AI crawler access matrix (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, …)
  • Citation readiness (structure, schema, E-E-A-T, passage length)
  • llms.txt detect / score / ready-to-publish draft
  • Domain compare with winner + insights
  • Prioritized action plan

v0.1 — Deterministic intelligence engine (HTTP + heuristics). No headless browser. Hosted on Talocode Cloud at /v1/geolane/*.


Install

npm install @talocode/geolane
export TALOCODE_API_KEY=tc_...
# optional
export TALOCODE_BASE_URL=https://api.talocode.site

Quick start (SDK)

import { GeoLaneClient } from '@talocode/geolane'

const geo = new GeoLaneClient({ apiKey: process.env.TALOCODE_API_KEY })

const report = await geo.audit({ url: 'https://example.com' })
console.log(report.score, report.grade, report.actions)

const draft = await geo.llmsTxt({ url: 'https://example.com' })
console.log(draft.draft)

Methods

Method Credits Description
health() Health check
pricing() Credit pricing
capabilities() Schema + endpoints
audit({ url }) 40 Full GEO audit
crawlers({ url }) 15 AI crawler allow/block matrix
llmsTxt({ url }) 20 Score + draft llms.txt
citationReadiness({ url }) 25 Page citation score
compare({ urlA, urlB }) 50 Domain comparison

Talocode Cloud SDK

import { Talocode } from '@talocode/sdk'

const tc = new Talocode({ apiKey: process.env.TALOCODE_API_KEY })
const report = await tc.geolane.audit({ url: 'https://talocode.site' })

CLI

npx geolane audit --url https://example.com
npx geolane crawlers --url https://example.com
npx geolane llms-txt --url https://example.com
npx geolane citation --url https://example.com
npx geolane compare --a https://a.com --b https://b.com
npx geolane pricing
npx geolane capabilities

Local engine commands (audit/crawlers/etc.) fetch public URLs from your machine — no API key required for local analysis.


Local server

GEOLANE_ALLOW_LOCAL_UNAUTH=true pnpm dev
# http://0.0.0.0:3030
Method Path Credits
GET /health
GET /v1/geolane/health
GET /v1/geolane/pricing
GET /v1/geolane/capabilities
POST /v1/geolane/audit 40
POST /v1/geolane/crawlers 15
POST /v1/geolane/llms-txt 20
POST /v1/geolane/citation-readiness 25
POST /v1/geolane/compare 50

With TALOCODE_API_KEY set, POST routes charge Talocode Cloud credits.


Library (offline engine)

import {
  analyzeCitationReadiness,
  parseRobotsForBot,
  generateLlmsTxt,
  scoreLlmsTxt,
} from '@talocode/geolane'

const citation = analyzeCitationReadiness(html, 'https://example.com')
const draft = generateLlmsTxt({
  domain: 'example.com',
  title: 'Example',
  description: 'Demo site',
  url: 'https://example.com',
})

MCP (Talocode Cloud)

When connected to Talocode MCP:

  • geolane_health / geolane_pricing / geolane_capabilities
  • geolane_audit · geolane_crawlers · geolane_llms_txt
  • geolane_citation_readiness · geolane_compare

Limitations (v0.1)

  • HTTP fetch only (no Playwright / JS rendering)
  • robots.txt root allow/disallow heuristic
  • Does not scrape live ChatGPT/Perplexity answer panels for citations

Talocode ecosystem

Part of Talocode — open-source workflow layers for builders. Explore sibling projects:

Project What it is
ScreenLane Screen-aware voice command layer
Tera AI chat & assistant
Codra Local coding agent
GateLane MCP gateway & agent tool control plane
ContextLane Context ingestion for persistent agents
MemoryLane Persistent agent memory
SignalLane X growth intelligence
ReplyLane X reply opportunity intelligence
CrawlerLane Crawler / SEO intelligence
WebDataLane Web extraction to structured data
SearchLane Search layer for agents
InvoiceLane Invoicing tools
GeoLane Geo intelligence (this repo)
UgcLane UGC workflows
OpenSourceLane Open-source distribution tools
StackLane Builder stack platform
Tradia Trading intelligence
Agent Browser Browser automation for agents
Talocode Org home & control plane
Skills Shared agent skills
X Agent X automation agent
LaunchPix Launch tooling
ForgeCAD CAD workflows
WorkLane Work automation
ClipLoop Clip / video loops

MCP-compatible agents integrate via each product's MCP server where available (Model Context Protocol).

More: github.com/talocode · talocode.site · docs.talocode.site

License

MIT

Support

Open-source Talocode products are built and maintained by Abdulmuiz Adeyemo.

Sponsor: https://github.com/sponsors/Abdulmuiz44

About

AI Search Visibility Intelligence API — GEO audit, AI crawler access, citation readiness, llms.txt, and domain compare for agents & developers.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors