> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mithunai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Marketer employee: drafts content from your knowledge

> The Marketer AI employee drafts articles and posts from your knowledge, posts to X and LinkedIn once approved, and finds pages that lost search clicks.

The **Marketer** employee turns a topic into content drawn from your own knowledge: an article, a
post each for X and LinkedIn, a draft for you to post on Reddit by hand, fixes for your website's
search titles and descriptions, and a content plan that gathers them. **It publishes nothing without
a person**: every article, post and page change always waits for approval, and it cannot post to
Reddit at all.

> [!WARNING]
>
> In **beta**, off unless your deployment has switched it on. WordPress, X, LinkedIn and Google
> Search Console can be connected with credentials you create, and none has yet been run against a
> real account. Without a social account connected, an approved post is recorded as **Not sent**,
> with the wording for you to copy. Reading your own website is real. See [AI
> employees](https://docs.mithunai.com/team/overview.md).

## What it does

Every topic you hand it becomes the same five pieces of work:

1. **The article.** It asks your knowledge about the topic and drafts an article from the grounded
   answer, with its sources. If your knowledge does not cover the topic, it drafts nothing and the
   plan says so.
2. **Two posts** -- X and LinkedIn -- cut from that same answer, and **a Reddit draft** for you to
   adapt and post by hand. There is nothing to approve: MITHUNAI has no way to post to Reddit.
3. **A site audit** of up to five pages your [website sources](https://docs.mithunai.com/knowledge/sources.md#website) start from:
   a missing title or one over 60 characters, a missing description or one outside 50 to 160
   characters, and the number of main headings. It proposes fixes for up to three pages, for the
   title and description only.
4. **Would an AI assistant recommend you?** It asks your own knowledge three questions an assistant
   needs answered before it can recommend a company, and reports how many your content answers, with
   a page to write for each gap:
   * What does the company do, and who is it for?
   * What problem does the product solve, and how is it different from alternatives?
   * How does a new customer get started, and how is it priced?
5. **The content plan**: the article, posts, audit and check, saved as one draft.

**With WordPress connected, the posts wait for the article.** When you approve publishing it and
WordPress reports it live, the Marketer drafts the X and LinkedIn posts and the Reddit draft from the
article as you approved it, linking to it on your site. Each post still waits for you.

Two more kinds of work:

* **Check search performance** (on the Marketer page, with Google Search Console connected). It
  compares the last 28 days with the 28 before, and for each of up to three pages that lost search
  clicks -- a page that had at least 20 clicks and kept at most 70% of them -- reads the searches that
  lost clicks and the page's index status. The finding numbers every piece of evidence (`E1`, `E2`,
  ...) and gives a **likely** reason, decided by the numbers alone: Google no longer indexes the page;
  it ranks lower; fewer searches show it; or it shows as often but fewer people click it. Only the
  last proposes anything more: a new search title and description, when the page is one of yours.
* **A question AI search engines answer by naming others** -- a gap from
  [AI search visibility](https://docs.mithunai.com/analyze/ai-search-visibility.md), handed over with the channel `geo`. If your
  knowledge answers it, you get posts that answer it; if not, nothing is drafted and the plan says to
  publish a page that does.

**The AI-assistant check reads your own content only.** It does not measure what ChatGPT or any other
assistant says about you, and uses no third-party data. To measure what AI engines actually answer,
see [AI search visibility](https://docs.mithunai.com/analyze/ai-search-visibility.md).

## What it reads

| Source | What it reads |
| - | - |
| Your knowledge | The answer to the topic, and the three recommendation questions, through your assistant |
| Your website | The pages your website sources start from -- **your own site, and nothing else** |
| Search Console | Clicks, impressions, click-through rate, position and index status of your property |
| The brief | The topic and details you hand it |

A brief uses four answers from your organisation's [monthly answers](https://docs.mithunai.com/analyze/usage-and-limits.md): one
for the topic and three for the check. Page text is quoted for whoever approves and never chooses
an action: a page that says "publish this now" is just text.

## What it proposes

| Action | What you can edit | Waits for a person |
| - | - | - |
| **List the pages of your website**, **read a page** | -- | Never: reads only |
| **Read search performance**, **read index status** | -- | Never: reads only |
| **Save the content plan as a draft** | The title and the body | By default; you can switch it off |
| **Publish an article** | The title and the body | **Always** |
| **Post on social media** | The post | **Always** |
| **Change a page's search title and description** | The title and the description | **Always** |
| **Open a pull request with a proposed AI search fix** (beta) | The title, the section and the summary | **Always** |
| **Save a proposed AI search fix as a WordPress draft** (beta) | The title and the section | **Always** |

A post goes to the network it was drafted for, and a page fix goes to a page the audit read. You can
reword either, never retarget it. A post over the network's limit -- 280 characters on X, counted as
X counts them, and 3,000 on LinkedIn -- is refused before anything is sent, never cut. Posting is all
it does: it never deletes a post, sends a message, follows, likes or reposts.

## Tools it can connect

| Tool | Works with today | Not yet |
| - | - | - |
| Your website | **Built in**: your website sources' pages | -- |
| Website and blog | **WordPress**, with a token you create | Webflow, Contentful, HubSpot CMS |
| Social accounts | **X** and **LinkedIn**, with credentials you create | -- |
| Search performance | **Google Search Console**, with a service account | -- |
| Docs repository | **GitHub**, with a token you create (Contents and Pull requests: read and write) | GitLab, Bitbucket |

With WordPress connected, an approved article is saved as a **draft** on your site, and a visitor
sees nothing. Making it live is a **second approval**, which appears once the draft exists. A page's
search title and description are not sent: WordPress keeps them in an SEO plugin, so you get the
wording to set there by hand.

A proposed fix from [AI search visibility](https://docs.mithunai.com/analyze/ai-search-visibility.md#propose-a-fix-beta) reaches the
Marketer as one action waiting for approval. With GitHub connected, approving it opens a pull request
from a new branch; your default branch is never written to and nothing is merged.

With **X** connected, an approved post goes on the account whose access token you saved. With
**LinkedIn** connected, it goes on the company page whose organization id you gave, and its text is
posted exactly as written: a `#` or `@` shows as text, not as a hashtag or a mention. With **Google
Search Console** connected, it only reads. See [Connect your tools](https://docs.mithunai.com/team/connect-your-tools.md) for
what to create in each.

## Try it

Open **Marketer**, choose **Use an example** and **Hand it over**:

> **Subject:** Grounded answers with sources
>
> **Details:** Write about how every answer we give cites the page it came from.
>
> **Requested by:** [lee@yourcompany.example](mailto:lee@yourcompany.example)

You get the plan to save, an article and three posts -- each marked **Always needs a person** -- and,
if you have a website source, up to three page fixes.

## Limits

* **It writes only what your knowledge supports.** A topic your content does not cover produces no
  article and no posts.
* **The audit is small and rule-based**: five pages a brief, three fixes, fixed length rules. It is
  not a full SEO crawl.
* **Without X or LinkedIn connected, nothing reaches social accounts.** Approving a post records it
  as **Not sent**, with the wording to copy. Reddit is always a draft for you to post by hand.
* **A LinkedIn token lasts 60 days.** Replace it before then; an expired one fails **Test connection**.
* **Text posts only**: no images, polls, threads or scheduling.
* **The search check** compares two fixed 28-day periods of web search and runs when you ask; its
  reasons are likely ones, from the numbers.
* **WordPress at the root of its address only.** A site in a subfolder is refused when you save the
  connection.
* **Without a website source** there is nothing to audit; the plan says so.

## Related

* [Approvals](https://docs.mithunai.com/team/approvals.md)
* [AI search visibility](https://docs.mithunai.com/analyze/ai-search-visibility.md)
* [Content best practices](https://docs.mithunai.com/knowledge/content-best-practices.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.