Serpzilla MCP Server

Create a new Serpzilla Guest Post article (Advertiser's Article) for a project. Returns articleId and urlId needed for purchase.

Add promoted URLs with anchor texts to a Serpzilla project. Each URL can have multiple anchor texts. Use #a#...#/a# markup within each text to specify the link portion. Used for purchasing placements where the webmaster (copywriter) writes the content. Returns urlId and textId needed for purchase.

Add domains to the Serpzilla Blacklist by domain IDs and/or domain names. Optionally scope the addition to project blacklists via project_ids. Returns a per-domain result (domainId, isError, errorMessage).

Remove domains from the Serpzilla Blacklist. Domains are identified by domain IDs only (from blacklist_get sections[].domainsList[].domainId). Optionally limit removal to specific project blacklists via project_ids.

Get domains from the Serpzilla Blacklist, grouped into sections. Returns the global Blacklist by default, or a project's own Blacklist when project_id is given. Supports pagination and sorting.

Create a new Serpzilla project for domain promotion.

Add domains to Serpzilla favorites lists. Domains can be identified by domain IDs, site IDs (from search results), or domain names. At least one identifier kind must be provided.

Create a new Serpzilla favorites list (a named group of donor domains). Returns the created list ID.

Remove domains from Serpzilla favorites lists. If list_ids is omitted, the domains are removed from ALL favorites lists.

Delete a Serpzilla favorites list. With is_delete_sites=false (default) the domains are moved to the general favorites list; with true they are deleted along with the list.

Get domains from a Serpzilla favorites list (grouped into sections), with pagination and optional filters (sort order, domain zones, availability to buy).

Get all Serpzilla favorites lists with domain counts.

Move domains from one Serpzilla favorites list to another.

Rename a Serpzilla favorites list.

Get a list of content (articles and texts) in a Serpzilla project with filtering, sorting, and pagination. Supports status, type, URL IDs, and search by substring.

Get a list of all placements in a Serpzilla project.

Get detailed information about a Serpzilla donor site (site card), including metrics, price, status, languages, statistics, etc.

Get current Serpzilla user information including account balance (balance field). To top up your balance, visit https://passport.serpzilla.com/deposit/

Get list of existing Serpzilla projects with optional pagination, sorting, and filtering. All parameters are optional; calling without arguments returns the first page.

Perform an action on one or more Serpzilla placements (e.g., approve, cancel). Allowed actions: force_billing_seo, approve_seo, approve_content_seo, approve_from_arbitration_seo, cancel_from_on_placement_seo, cancel_from_improve_seo, cancel_seo, terminate_seo, cancel_order_change_links_seo, price_changing_action_accept_seo, guarantee_wm, accept_order_change_links_wm, price_changing_action_reject_wm, delete_draft_seo, buy_from_buy_fail_seo, delete_from_buy_fail_seo.

Purchase contextual (Niche Edit) link placements on selected Serpzilla donor pages. The search_id, force_seo_wait, mos_sites, and pages_extra values must come from a prior search_context_sites call (data.searchId, data.forceSeoWait, data.mosSites, data.pagesExtra). Each item in pages needs: page_id = donor page ID (resultList[].pages[].id from the search response); url_id = promoted URL ID; text = the ANCHOR: a short phrase copied VERBATIM from the chosen snippet — it becomes the link (NO #a#...#/a# markup is used for contextual placements); full_text = that same snippet copied UNCHANGED from resultList[].pages[].snippets[] — the API matches the anchor inside this snippet, so keep its wording and HTML tags (e.g. <b>) intact. Example: for the snippet '- качественно и с душой( <b>Натяжные потолки</b> с точечной подсветкой' use text='Натяжные потолки' and full_text=the whole snippet string. Returns the created placement IDs.

Purchase a placement on a selected Serpzilla donor site.

Purchase rental (monthly-billed) link placements on selected Serpzilla donor pages. The search_id, force_seo_wait, mos_sites, and pages_extra values must come from a prior search_rent_sites call (data.searchId, data.forceSeoWait, data.mosSites, data.pagesExtra). Each page in pages needs: page_id (donor page ID from search results resultList[].pages[].id), url_id (promoted URL ID), and text_id (anchor text ID). Returns the created placement IDs.

Search Serpzilla donor sites for contextual (Niche Edit) links by URL ID and filters. The search runs asynchronously: this tool polls internally until results are ready (up to 150s) and returns them. The response contains data.resultList (found sites, each with nested pages[] where pages[].id = pageId identifies a purchasable donor page and pages[].snippets[] lists text fragments of that page where a link can be inserted). When buying later via purchase_context_placement, pass the chosen snippet UNCHANGED as its full_text and pick the anchor phrase inside it as its text. The response also carries the echo values needed to buy: data.searchId, data.forceSeoWait, data.mosSites, data.pagesExtra — pass those plus the selected page IDs into purchase_context_placement.

Search Serpzilla donor sites for rental (monthly-billed) links by URL ID and filters. The search runs asynchronously: this tool polls internally until results are ready (up to 150s) and returns them. The response contains data.resultList (found sites, each with nested pages[].id = pageId identifying purchasable donor pages) and the echo values needed to buy: data.searchId, data.forceSeoWait, data.mosSites, data.pagesExtra. Pass those echo values plus selected page IDs into the purchase_rent_placement tool.

Search Serpzilla donor sites by given filters.

Set usage limits for Serpzilla content (anchors/texts). Targets either specific content IDs or all content of a URL. Limit 0 means no restrictions.

Update a Serpzilla promoted URL: URL, title and link decoration (hiding links from search engines). The url field is required; pass the current URL unchanged if it should not be modified.