Botify integration
Botify is an enterprise SEO platform that crawls websites and joins the crawl with log files, Google Search Console and analytics data. List the projects of a Botify account and their crawl analyses, read an analysis summary, crawl statistics, sitemap, inlink, PageRank and segment reports, inspect the crawl data of one URL, run BQL queries, launch, pause or resume a crawl, and start and follow export jobs. The legacy Google Analytics orphan URL report, the duplicate unpaginated project listing and the BQLv1 aggregation routes (whose documented answer omits the aggregated values) are not included. Authentication is the API token from the Tokens panel of your Botify account page, sent in the Authorization header after the word Token.
Say what should happen.
The workflow builds itself.
What you can do with Botify
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Export, 3 operations
create_urls_exportCreate urls exportPOSTStarts a CSV export of the URLs of one analysis matching a BQLv1 query (fields, filters, sort). Returns the export job; follow it with get_urls_export until job_status is DONE or FAILED.get_urls_exportGet urls exportGETReturns the status of one URL export job of an analysis: job_status, the number of exported URLs and, once the job has finished, its results.list_urls_exportsList urls exportsGETLists the URL export jobs of an analysis with their status, number of results and query.
Job, 3 operations
create_jobCreate jobPOSTCreates a job, typically an export of a BQL query: job_type export with a payload giving username, project, export_size, formatter, connector and query. Follow it with get_job.get_jobGet jobGETReturns one job: its type, status (CREATED, PENDING, PROCESSING, DONE or FAILED), payload and, once finished, its results.list_jobsList jobsGETLists the jobs of the account (exports and other job types), with their status, payload and results. Filter by job_type, project or analysis.
Url, 3 operations
get_url_detailGet url detailGETReturns the crawl data Botify stored for one URL of an analysis. Pass fields to choose which datamodel fields come back.list_latest_crawled_urlsList latest crawled urlsGETReturn a list of 1000 latest URLs crawled (all crawled URLs or only URLS with HTTP errors)query_analysis_urlsQuery analysis urlsPOSTRuns a BQLv1 query on the URLs of one analysis (fields to return, filters, sort) and returns one page of matching URLs. query_project with BQLv2 is the newer way to query several collections.
Analyse, 2 operations
get_analysisGet analysisGETReturns the detail of one crawl analysis: its owner, slug, status, features, configuration, URL counts and launch and finish dates.list_analysesList analysesGETLists the crawl analyses of a project with their slug, status, launch and finish dates and URL counts. Set only_success=false to include analyses that did not finish successfully.
Collection, 2 operations
get_collectionGet collectionGETGet the detail of a collectionlist_collectionsList collectionsGETList all collections for a project
Filter, 2 operations
get_saved_filterGet saved filterGETRetrieve a specific project saved, account or recommended filter's name, ID and filter valuelist_saved_filtersList saved filtersGETList all the project's saved filters (each filter's name, ID and filter value)
Robots txt indexe, 2 operations
get_robots_txt_fileGet robots txt fileGETReturns the content of one robots.txt file found during an analysis, by the file name listed by list_robots_txt_files.list_robots_txt_filesList robots txt filesGETReturn an object containing all robots.txt files found on the project's domains. The object is null for virtual robots.txt.
Account filter, 1 operation
list_account_filtersList account filtersGETList all the account saved filters
Ai, 1 operation
get_url_ai_suggestionsGet url ai suggestionsGETGets AI suggestions of an URL for an analysis
Clone, 1 operation
clone_keyword_groupsClone keyword groupsPOSTCopies every keyword group of this project to another project of the target user.
Crawl statistic, 1 operation
get_crawl_statisticsGet crawl statisticsGETReturn global statistics for an analysis
Datamodel, 1 operation
get_urls_datamodelGet urls datamodelGETReturns the datamodel of an analysis: every field that query_analysis_urls and create_urls_export can return or filter on, with its id, type and group.
Dataset, 1 operation
get_urls_datasetsGet urls datasetsGETReturns the datasets of an analysis: the groups of fields available for URL queries, with each field's id, type and suggested operations.
Datasources summary by project, 1 operation
get_datasources_summaryGet datasources summaryGETReturns, for every project of a user, its data sources with the date of their last successful revision and the status of their last revision.
Domain, 1 operation
list_top_linked_domainsList top linked domainsGETLists the top external domains linked from the crawled pages, with follow and nofollow link counts and sample links for each domain.
Html, 1 operation
get_url_htmlGet url htmlGETReturns the HTML Botify stored for one URL of an analysis. Available when the analysis kept raw pages (has_raw_pages in get_analysis).
Launch, 1 operation
launch_analysisLaunch analysisPOSTCreates and launches a new crawl analysis for a project.
Light, 1 operation
list_analyses_lightList analyses lightGETLists the crawl analyses of a project with a lighter record per analysis (slug, name, status, dates, URL counts) than list_analyses.
Lost, 1 operation
get_lost_pagerankGet lost pagerankGETReturns how much internal PageRank an analysis loses to non-crawled URLs, to external links and to URLs blocked by robots.txt.
Orphan url, 1 operation
list_visits_orphan_urlsList visits orphan urlsGETList of Orphan URLs. URLs which generated visits from the selected source according to Google Analytics data.
Out of config, 1 operation
list_sitemap_urls_out_of_configList sitemap urls out of configGETSample list of URLs which were found in your sitemaps but outside of the crawl perimeter defined for the project.
Pause, 1 operation
pause_analysisPause analysisPOSTPauses a running crawl analysis. Resume it with resume_analysis.
Percentile, 1 operation
get_inlinks_percentilesGet inlinks percentilesGETReturns the inlinks percentiles of an analysis: for each percentile bucket of crawled URLs, the minimum, maximum and average number of inlinks.
Project, 1 operation
list_projectsList projectsGETLists the active projects of a Botify user or organization, with their slug, name and settings. Filter by project name.
Query, 1 operation
query_projectQuery projectPOSTRuns a BQL (BQLv2) query on a project: collections and periods to read, dimensions, metrics, filters and sort. Returns up to 2000 rows per page.
Report, 1 operation
get_sitemaps_reportGet sitemaps reportGETGet global information of the sitemaps found (sitemaps indexes, invalid sitemaps urls, etc.)
Resume, 1 operation
resume_analysisResume analysisPOSTResumes a paused crawl analysis.
Saved explorer, 1 operation
list_saved_explorersList saved explorersGETList all the project's Saved Explorers.
Segment, 1 operation
list_segmentsList segmentsGETGet the segments feature public metadata of an analysis.
Sitemap only, 1 operation
list_sitemap_only_urlsList sitemap only urlsGETSample list of URLs which were found in your sitemaps, within the project allowed scope (allowed domains/subdomains/protocols), but not found by the Botify crawler.
Stat, 1 operation
get_search_console_statsGet search console statsGETList clicks and impressions per day
Subdomain, 1 operation
list_top_linked_subdomainsList top linked subdomainsGETLists the top external subdomains linked from the crawled pages, with follow and nofollow link counts and sample links for each subdomain.
Summary, 1 operation
get_scoring_summaryGet scoring summaryGETReturns the scoring summary of an analysis, as computed by Botify for the crawl.
Time, 1 operation
get_crawl_statistics_over_timeGet crawl statistics over timeGETReturn crawl statistics grouped by time frequency (1 min, 5 mins or 60 min) for an analysis
Use Botify from Claude Code, Cursor or Codex
Connect Botify in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Botify operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Botify
- Create your workspace
Sign up free. Nothing to install.
- Connect Botify once
Add your Botify connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Botify integration FAQ
What can you do with the Botify integration?
LiveContext exposes 44 operations on Botify, covering export, job, url and analyse.
