approve_post
ChatGPTApprove a Ready post and queue it for publication at its scheduled time. Returns the updated post.
Business & Operations
Overview
VibeSEO helps website owners with keyword and competitor research, Google Search Console monitoring, technical site audits, and AI-assisted blog idea generation, drafting, approval, and scheduling — all scoped to the user's projects inside VibeSEO.
Tools
autocomplete_keywords
ChatGPTGoogle-autocomplete-style keyword suggestions for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls. Each suggestion comes back with its own locationCode/languageCode — use this tool (or related_keywords) to discover the right market before calling get_keyword_metrics for keyword difficulty. Filter results by volume, CPC, difficulty, intent.
comparison_keywords
ChatGPTComparison-style suggestions ("X vs Y", "X alternative", ...) for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.
competitive_overview
ChatGPTSide-by-side metrics for a primary domain and its competitors: traffic, keywords, backlinks, common keywords, gap size, monthly trend.
domain_competitor_suggestions
ChatGPTSuggested competitor domains based on keyword overlap and similar audience.
domain_overview
ChatGPTAuthority, organic/paid traffic estimate, keyword count, backlink count, and rank distribution for a domain.
domain_top_keywords
ChatGPTTop organic keywords the domain ranks for, with position, volume, traffic, and SERP features.
domain_top_pages
ChatGPTTop pages on the domain by estimated organic traffic.
domain_traffic_history
ChatGPTMonthly organic traffic history for a domain.
generate_post
ChatGPTTrigger AI draft generation for a scheduled Idea or Drafting post. Returns the post ID.
get_audit
ChatGPTAudit metadata + summary scores by audit ID.
get_audit_summary
ChatGPTCondensed audit scorecard: category breakdown, top recurring rule codes, average response time, indexable pages percent.
get_keyword_metrics
ChatGPTMAX 5 KEYWORDS PER CALL. Sending 6 or more returns a 400 validation error — split larger lists across multiple calls. KEYWORD DIFFICULTY REQUIRES locationCode AND languageCode — worldwide calls (both omitted) return null KD for every keyword. If the target market is unknown, first call autocomplete_keywords or related_keywords; their results include locationCode/languageCode per suggestion, which you can then pass back here. Looks up search volume, CPC, KD, and intent for 1 to 5 keywords.
get_location_by_code
ChatGPTLook up a single location by its DataForSEO location code, e.g. 2840 for United States.
get_month_view
ChatGPTRead all posts scheduled in a given month, grouped for calendar display.
get_post
ChatGPTRead a single post (markdown body, FAQ, internal links, SEO score, status, schedule).
get_project
ChatGPTGet a single project by ID.
get_publication
ChatGPTRead a single publication snapshot including daily impression/click signals.
get_site_information
ChatGPTRead the project's site information record (brand, audience, pain points, CTAs).
gsc_query_details
ChatGPTGSC performance for a specific list of queries.
gsc_status
ChatGPTGSC connection status for a project: connected/pending/invalid, bound site, last sync time. Call this before gsc_summary or gsc_top_* to detect a missing connection cheaply.
gsc_summary
ChatGPTAggregate GSC performance for the project over a window: clicks, impressions, CTR, avg position, deltas vs previous period.
gsc_top_pages
ChatGPTTop landing pages from GSC for a project.
gsc_top_queries
ChatGPTTop search queries from GSC for a project.
gsc_trend
ChatGPTDaily GSC trend (clicks, impressions, position) over a window.
keyword_gap
ChatGPTKeywords the competitor ranks for that the primary domain doesn't (highest-opportunity gap targets), or common keywords. Returns { totalCount, items }.
list_audit_issues
ChatGPTFiltered list of issues from an audit. Filter by category (on-page, technical, content, performance, ...) or severity (critical, warning, info).
list_audits_for_project
ChatGPTAll audits previously run for a project, newest first.
list_cities
ChatGPTList cities supported within a country. Country code is ISO 3166-1 alpha-2, e.g. "US".
list_competitors
ChatGPTList the project's tracked competitors.
list_countries
ChatGPTList supported DataForSEO country locations (location codes + ISO codes).
list_crawled_pages
ChatGPTTop crawled pages from the project's most recent completed audit (URL, title, meta, word count). Useful for fact-checking and finding internal-link targets.
list_domain_history
ChatGPTReturn the calling user's recent domain search history.
list_keyword_history
ChatGPTReturn the calling user's recent keyword search history.
list_languages
ChatGPTList supported languages (language code + display name).
list_posts
ChatGPTList posts for a project. Filter by status: Idea, Drafting, Ready, Approved, Published.
list_projects
ChatGPTList the calling user's VibeSEO projects.
list_publications
ChatGPTList published article snapshots (read-only history) for the project, with traffic signals.
preposition_keywords
ChatGPTSuggestions containing prepositions (for/with/near/...) for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls.
question_keywords
ChatGPTQuestion-format suggestions (what/how/why/when/...) for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls. Useful for FAQ and informational content.
refill_queue
ChatGPTQueue an async strategist job that appends new Idea-status posts to the queue (additive — does not touch existing posts). Returns a job acceptance immediately; new Idea posts appear in list_posts within ~30–60 seconds.
refresh_ideas
ChatGPTQueue an async strategist job that replaces existing Idea-status posts with a fresh batch (Drafting/Ready/Approved/Published are untouched). Returns a job acceptance immediately; new Idea posts appear in list_posts within ~30–60 seconds.
reject_post
ChatGPTReject a Ready post: clears the body and returns it to Drafting with the reason recorded. Returns the updated post.
related_keywords
ChatGPTSynonym-expansion related keywords for 1 to 5 seed keywords per call. MAX 5: sending more returns a 400 validation error — split larger lists across multiple calls. Each suggestion comes back with its own locationCode/languageCode — use this tool (or autocomplete_keywords) to discover the right market before calling get_keyword_metrics for keyword difficulty.
replace_competitors
ChatGPTReplace the project's competitor list with the supplied set of domains. Returns the new competitor list.
schedule_post
ChatGPTSet or change the scheduled_for date on a post (Idea, Drafting, or Ready). Returns the updated post. To remove a scheduled date, call unschedule_post instead.
score_keyword
ChatGPTScore a candidate keyword against this project's archetype to get a 0-100 priority score with breakdown. The keyword must already appear in the project's top-100 ranking set.
search_locations
ChatGPTSearch countries and cities by name. Useful for resolving a city name to its DataForSEO location code.
start_site_audit
ChatGPTTrigger a new site audit (crawl + on-page/technical analysis). Runs asynchronously; poll get_audit until status="completed".
unschedule_post
ChatGPTClear the scheduled_for date on a post (Idea, Drafting, or Ready), returning it to the unscheduled state. Returns the updated post. Content is preserved.
