Leafpad

Read Google Search Console performance (clicks, impressions, CTR, average position) for an organization's connected property. Data is read live from Google with the Search Console connection set up in LeafPad. The latest two days are left out because Google is still filling them in, and Search Console keeps about 16 months. Args: - organization_slug (string): Organization slug (e.g. 'acme-corp') - dimensions (array, optional): Group rows by any of 'query', 'page', 'date', 'country', 'device', 'searchAppearance' (default ['query']) - days (integer, optional): Length of the window ending at the latest complete day (default 28, up to 484) - start_date / end_date (string, optional): Explicit range as YYYY-MM-DD; both together, in place of days - row_limit (integer, optional): Rows to return, 1-25000 (default 100) - start_row (integer, optional): Offset for paging (default 0) - query_contains (string, optional): Only queries containing this text - page_contains (string, optional): Only page URLs containing this text - country (string, optional): ISO 3166-1 alpha-3 country code, e.g. 'usa' - device ('DESKTOP' | 'MOBILE' | 'TABLET', optional) - response_format ('markdown' | 'json'): Output format (default 'markdown') Returns: Rows of Search Console metrics for the property, with the date range used. Organizations without Search Console connected return an error saying so.

leafpad_get_search_console_data

Fetch a single blog post from LeafPad by organization slug and post slug. Args: - organization_slug (string): Organization slug (e.g. 'acme-corp') - post_slug (string): Post slug. Nested paths are supported (e.g. 'docs/getting-started') - content_format ('markdown' | 'html' | 'json'): Format for the post body (default: 'markdown') - response_format ('markdown' | 'json'): Metadata wrapper format (default: 'markdown') Returns: Full post data: title, slug, ID, tags, SEO metadata, author, body content, where the post redirects (301) when it does, and which posts redirect to it.

leafpad_get_post

Read one proposed refresh: the page, why it was selected, the current text, the proposed text, and whether it can be approved. Does not publish anything. Approving and rejecting are separate tools. A review card is shown when the host supports it. Args: - organization_slug: Site slug from leafpad_list_organizations - proposal_id: Proposal id from find_pages_needing_attention

get_refresh_proposal

Answer a question using indexed company content stored in the knowledge base. Queries the Pinecone vector index scoped to the organisation's configured site, so only content belonging to that company is searched. Returns the most relevant text chunks along with their sources. Args: - organization_slug (string): Organization slug (e.g. 'acme-corp') - question (string): The question or search query to answer from company content. - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns: Relevant company content chunks that best answer the question.

leafpad_get_company_data

Redirect one post permanently (301) to another post of the same site, or remove its redirect. Typical use: two pages compete for the same searches, and the weaker one should send its visitors and ranking to the stronger one. LeafPad records the redirect and reports it in its public post API; the site serving the page answers the old URL with a 301. Once redirected, the post is left out of sitemaps, listings, refreshes, internal links and CMS sync. The destination must be a published article of the same site that is not itself redirected. Folders and posts with pages under them cannot be redirected. Posts already redirecting to this one are moved to the new destination, so no chain is created. Args: - organization_slug: Site slug from leafpad_list_organizations - post_id: Numeric id of the post to redirect, from leafpad_list_posts or leafpad_get_post - destination_post_id: Numeric id of the post to redirect to, or null to remove the redirect Returns: Where the post now redirects (path and URL), or that its redirect was removed.

leafpad_set_redirect

Turn down one refresh proposal. The live page is not changed, and the proposal's place for today is released. Args: - organization_slug: Site slug from leafpad_list_organizations - proposal_id: Proposal id from get_refresh_proposal

reject_refresh

Remove posts or rewrites from a LeafPad organization's content calendar so they never run. Nothing already written or published is touched, and nothing is charged. A row that already ran is kept as history, and a rewrite whose generation has started cannot be stopped this way; both are reported and left in place. Args: - organization_slug (string): Organization slug from leafpad_list_organizations - scheduled_post_ids (array of int, 1-50): Scheduled post IDs from leafpad_list_scheduled_posts or the scheduling tools Returns: Which rows were removed, and which were left and why.

leafpad_delete_scheduled_posts

Schedule one or more new blog posts to be written by AI at a future time in a LeafPad organization. At the scheduled time LeafPad generates the post from its title and prompt, using the organization's settings and guardrails, and charges $1 to the organization's balance. Posts you write yourself with leafpad_create_post are never charged. Rewrites of posts that already exist are scheduled with leafpad_schedule_rewrites instead. Args: - organization_slug (string): Organization slug (e.g. 'acme-corp') - posts (array): Posts to schedule. Each item has: - title (string): Post title / keyword the post is generated about (required) - date (string): ISO 8601 datetime when the post is generated (required, e.g. '2025-06-01T09:00:00Z') - prompt (string, optional): The brief for generation (angle, sections, tone, audience). Replaces the bare title as the brief when given - volume (integer, optional): Monthly search volume of the keyword (>= 0) - kd (integer, optional): Keyword difficulty of the keyword, 0-100 - intent (string, optional): Search intent, e.g. 'informational', 'commercial', 'transactional' - post_type ('ARTICLE' | 'FOLDER', optional): Kind of post generated (default 'ARTICLE') - parent_id (integer, optional): ID of an existing folder post the new post is nested under - parent_scheduled_post_id (integer, optional): ID of another scheduled post (a folder) whose generated post becomes the parent Returns: Summary of how many posts were scheduled successfully, with per-item status and scheduled post IDs.

leafpad_add_scheduled_posts

Update a post the signed-in user can edit. Overwrites only the fields that are provided. Replacing html_content replaces the public HTML. publish_post publishes a draft. The post id is the numeric id from leafpad_list_posts or leafpad_get_post. Args: - organization_slug (string): Site slug from leafpad_list_organizations - post_id (int): Numeric post id - name (string, optional): New title - slug (string, optional): New post slug, unique within the site - html_content (string, optional): Replacement HTML body - published (bool, optional): Published flag. publish_post publishes a draft. - seo_title (string, optional): SEO title - seo_description (string, optional): Meta description - seo_keywords (string, optional): Comma-separated SEO keywords Returns: Updated title, slug, published flag, and which fields changed.

leafpad_update_post

Change a post or rewrite on a LeafPad organization's content calendar before it runs. Only the fields given change. A row that already ran cannot be changed, and neither can a rewrite whose generation has started. Which fields apply depends on the row's type (leafpad_list_scheduled_posts shows it): - every type: date - new post: title, prompt, volume, kd, intent, post_type, parent_id, parent_scheduled_post_id - rewrite: instructions, target_keywords, url, volume, kd, intent - publish existing post: date only Args: - organization_slug (string): Organization slug from leafpad_list_organizations - scheduled_post_id (int): Scheduled post ID from leafpad_list_scheduled_posts or the scheduling tools - date (string, optional): New ISO 8601 datetime, e.g. '2025-06-01T09:00:00Z' - title (string, optional): New post title / keyword - prompt (string, optional): New generation brief; '' clears it - volume (int, optional): Monthly search volume (>= 0) - kd (int, optional): Keyword difficulty, 0-100 - intent (string, optional): Search intent; '' clears it - post_type ('ARTICLE' | 'FOLDER', optional): Kind of post generated - parent_id (int, optional): Existing folder post to nest under; 0 removes it - parent_scheduled_post_id (int, optional): Scheduled folder whose post becomes the parent; 0 removes it - instructions (string, optional): New direction for the rewrite; '' clears it - target_keywords (array, optional, up to 12): Replaces the rewrite's keywords, first one primary; [] clears them. Each item: keyword (string), volume (int, optional) - url (string, optional): Page path as Search Console reports it Returns: The row as it now stands.

leafpad_update_scheduled_post