AdsAgent

io.github.nowork-studio由 GitHub 帳號 nowork-studio 發布v0.2.23更新於 Nov 2, 2026

Google Ads analysis and operations — read performance, manage keywords, bids, and campaigns.

發布方自己的服務：AdsAgent — Google Ads MCP

已驗證Streamable HTTP可網頁執行資料與分析商業與電商

概覽

AI 產生的概覽

透過 OAuth 連線的遠端 MCP 伺服器，用於 Google Ads：檢視廣告成效，並管理關鍵字、出價、預算與廣告活動。

可以做什麼
  • 檢視 Google Ads 廣告活動成效、搜尋字詞與變更記錄
  • 管理支援的關鍵字、出價、預算、排除關鍵字與廣告活動
  • 稽核帳戶健康狀態、驗證追蹤設定並找出浪費的支出
  • 撰寫 RSA 文案，規劃網站連結、宣傳資訊等素材
  • 診斷關鍵字、廣告與到達網頁之間的關聯性
適用情境
適合需要讓助理稽核 Google Ads 帳戶、說明預算浪費在哪裡，或在對話中執行已核准的出價、關鍵字與預算調整的情境。
執行需求
需要連線至 adsagent.org 的遠端端點（streamable HTTP），並完成 OAuth 登入。未宣告任何環境變數或標頭。帳戶須在 OAuth 過程中選擇的工作區內完成連結後才會可用。
安裝前請注意
此伺服器可修改線上廣告帳戶，包括出價、預算、關鍵字與廣告活動，核准前應逐項核對變更。OAuth 會授予所連結廣告帳戶的存取權，工具參數與結果會經過託管服務。只連結你確實要使用的帳戶。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 AdsAgent，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.nowork-studio%2Fadsagent/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "adsagent": {
      "type": "http",
      "url": "https://adsagent.org/api/mcp"
    }
  }
}

README

NotFair Plugin

[License: MIT] [Discord]

Open-source SEO, GEO, and marketing skills for AI agents.

The NotFair Plugin gives Claude Code, Codex, Hermes, and other compatible agents practical marketing workflows they can follow—not another generic prompt collection. Use it to audit a site, investigate a traffic drop, analyze GA4 and Search Console, find wasted ad spend across Google, Meta, X, LinkedIn, Reddit, and TikTok, operate connected WordPress and GoHighLevel accounts, build campaign plans, and make reviewable changes.

Each skill has one discoverable skills/<name>/SKILL.md entry point. It loads a readable WORKFLOW.md in the category folder, with supporting references, scripts, and evals where needed. Inspect it, adapt it, or contribute a better workflow.

What your agent can do

AreaExamples
SEOFull-site and page audits, keyword research, content planning, technical SEO, schema, local SEO, international SEO, e-commerce SEO, and regression monitoring
GEO / AEOImprove content for citation and visibility in ChatGPT, Perplexity, Gemini, Claude, and Google AI Overviews
Paid mediaPlan, review, and optimize cross-channel campaigns with explicit budgets, measurement, and approval boundaries
Google AdsAudit accounts, analyze search terms, manage keywords and budgets, write RSA copy, plan assets, and diagnose landing pages
Meta AdsReview Facebook and Instagram performance, diagnose creative fatigue, assess audiences, and create evidence-based creative briefs
X AdsAnalyze campaigns and line items, review conversion performance, manage targeting and creative, and execute approved changes
LinkedIn AdsConnect B2B media to lead quality, analyze campaign groups and campaigns, and manage targeting, creative, conversions, and leads
Reddit AdsAnalyze campaigns, ad groups, and ads, review conversions and audiences, and execute approved Reddit Ads changes
TikTok AdsAnalyze connected TikTok advertisers, review delivery and creative performance, and execute approved campaign changes
WordPressRead and update connected WordPress content, media, comments, design, settings, plugins, and approved site changes
GoHighLevelRead contacts, conversations, opportunities, and calendars, then make only explicitly requested CRM changes
AnalyticsQuery live GA4 and Search Console data, compare complete periods, inspect URLs, manage sitemaps, and update supported measurement configuration
ContentTurn search demand into editorial plans, briefs, articles, landing pages, metadata, and structured data

The NotFair Plugin currently ships 48 skills across SEO, GEO, paid media, advertising platforms, analytics, WordPress, CRM, and cross-model review.

Quick start

Claude Code

Install the NotFair plugin from its marketplace:

text
/plugin marketplace add nowork-studio/notfair-plugin/plugin install notfair@nowork-studio

Then ask for the workflow you need:

text
/notfair:seo-analysis/notfair:geo-optimizer/notfair:google-ads-audit/notfair:meta-ads-creative/notfair:paid-ads-x/notfair:google-analytics/notfair:search-console

You can also use plain language:

Audit my site and tell me why organic traffic fell.

Find pages that could earn citations in AI answers.

Review last month's ad spend and show me the safest opportunities to improve ROAS.

Cursor

Install NotFair from Cursor's plugin marketplace. The plugin loads the open-source marketing skills in this repository and registers one hosted NotFair MCP connection. Complete the browser OAuth flow when Cursor prompts you, then ask Cursor to audit an ad account, analyze GA4 or Search Console, or run one of the SEO and GEO workflows listed below.

For local testing before the marketplace listing is available, clone this repository into Cursor's local plugin directory:

bash
git clone https://github.com/nowork-studio/notfair-plugin.git ~/.cursor/plugins/local/notfair

Restart Cursor after installing or updating the local plugin.

Kiro Powers

Install the public repository as a custom power from Kiro's Powers panel, or find NotFair in the Powers registry after its listing is approved. The root plugin.json and mcp.json follow the Agent Plugins 1.0 specification.

Gemini CLI

Install the extension directly from GitHub:

bash
gemini extensions install https://github.com/nowork-studio/notfair-plugin

The extension loads the repository guidance and the universal NotFair MCP. Run /mcp auth NotFair in Gemini CLI when authentication is requested.

Codex, Hermes, and other agents

Install the universal NotFair plugin directly through Codex:

bash
codex plugin marketplace add nowork-studio/notfair-plugin --json && codex plugin add notfair@nowork-studio --json && codex mcp login NotFair

Codex installs the skills, registers one NotFair MCP connection, and opens its OAuth flow. If you prefer a workspace-local checkout, clone the repository and open it as a workspace; AGENTS.md maps marketing requests to the right skill.

bash
git clone https://github.com/nowork-studio/notfair-plugin.gitcd notfair-plugin

If the nowork-studio marketplace is already configured, refresh it instead:

bash
codex plugin marketplace upgrade nowork-studio --json && codex plugin add notfair@nowork-studio --json && codex mcp login NotFair

For host-specific setup, give your agent INSTALL_FOR_AGENTS.md, or paste:

text
Retrieve and follow the instructions at:https://raw.githubusercontent.com/nowork-studio/notfair-plugin/main/INSTALL_FOR_AGENTS.md

Guides and comparisons

Background reading on connecting ad accounts to AI agents and choosing a setup:

Why skills instead of one giant marketing agent?

Marketing work gets unreliable when every request goes through the same vague prompt. The NotFair Plugin splits the work into focused, testable procedures.

  • Specialized: each skill has a defined job, required inputs, decision rules, and output format.
  • Evidence-led: live-data workflows use Search Console, Google Analytics, Google Ads, Meta Ads, X Ads, LinkedIn Ads, Reddit Ads, TikTok Ads, WordPress, or GoHighLevel instead of guessing from generic best practices.
  • Safe by design: read-only review comes before mutation, paid-media changes stay explicit, and unsupported capabilities are never implied.
  • Host-agnostic: the canonical skills are plain files, not logic trapped inside one agent runtime.
  • Forkable: everything is MIT licensed, so teams can review and adapt the workflows to their own standards.

Skill catalog

SEO and GEO

SkillWhat it does
seo-analysisAudits a full site with Search Console and crawl data, then prioritizes the highest-impact fixes.
seo-pagePerforms a deep audit of one URL for intent, content, structure, and on-page SEO.
content-writerWrites or improves search-led articles, landing pages, and service pages.
content-plannerTurns Search Console opportunities into a prioritized, dated editorial calendar.
keyword-researchBuilds a keyword universe, classifies intent, and organizes topic clusters.
meta-tags-optimizerImproves titles, meta descriptions, Open Graph tags, and SERP click-through potential.
schema-markup-generatorCreates and validates JSON-LD structured data.
broken-link-checkerFinds broken internal and external links and reports site-health issues.
geo-optimizerAudits and rewrites content for citation in AI search and answer engines.
local-seoReviews Google Business Profile, local pages, NAP consistency, reviews, and local schema.
hreflang-internationalDiagnoses hreflang, canonical, language, and regional targeting problems.
sitemap-auditChecks XML sitemap structure, freshness, coverage, and URL validity.
image-seoReviews alt text, formats, compression, responsive images, CLS, and image discovery.
ecommerce-seoAudits product pages, category pages, variants, faceted navigation, and product schema.
programmatic-seoPlans useful templated pages at scale with demand, uniqueness, and indexation guardrails.
competitor-pagesCompares ranking pages and produces a practical SERP brief.
sxoConnects search visibility and SERP CTR to the post-click conversion experience.
seo-driftCreates a baseline and detects ranking, metadata, canonical, and indexation regressions.
backlink-auditReviews referring domains, anchor text, link risk, and internal-link opportunities.
setup-cmsLocal Application-Password / .env.local setup for SEO scripts against WordPress, Strapi, Contentful, or Ghost.

Paid media

SkillWhat it does
paid-adsRoutes broad paid-media questions to the right channel and workflow.
paid-ads-setupConnects accounts and captures business, economics, tracking, and budget context.
paid-ads-launchProduces a reviewable campaign or multi-channel experiment plan before spend begins.
paid-ads-reviewCreates comparable weekly or monthly scorecards and checks tracking health.
paid-ads-optimizeFinds waste and pacing problems, then proposes narrow, reversible changes.
paid-ads-creativeDevelops cross-channel concepts, claim ledgers, fatigue hypotheses, and test briefs.
paid-ads-xAudits and operates connected X Ads campaigns, line items, targeting, creative, audiences, and budgets.
paid-ads-linkedinAudits and operates connected LinkedIn Ads around qualified pipeline outcomes.
paid-ads-redditAudits and operates connected Reddit Ads campaigns, ad groups, ads, audiences, pixels, and budgets.
paid-ads-tiktokAudits and operates connected TikTok Ads delivery, creative, targeting, and budgets.
paid-ads-amazonPlans and reviews Amazon Ads with margin-aware ACoS guardrails.
paid-ads-chatgptDesigns bounded ChatGPT Ads experiments or reviews verified exports.
paid-ads-integrationsVerifies connector, account, and tool access before promising a capability.
paid-ads-guideExplains installation, supported platforms, limits, and troubleshooting.

Google Ads

SkillWhat it does
google-ads-auditScores account health, validates tracking, and finds wasted spend.
google-adsReviews performance and manages supported keywords, bids, budgets, negatives, and campaigns.
google-ads-copyWrites compliant RSA headlines and descriptions with test variants.
google-ads-assetsPlans sitelinks, callouts, snippets, image assets, and Performance Max briefs.
google-ads-landingDiagnoses keyword-to-ad-to-page relevance and landing-page quality.

Meta Ads

SkillWhat it does
meta-ads-auditAudits tracking, structure, creative health, audiences, spend efficiency, and scaling readiness.
meta-adsReviews Facebook and Instagram performance and executes supported campaign operations.
meta-ads-creativeProduces evidence-based concepts, copy angles, UGC briefs, and refresh experiments.

Analytics

SkillWhat it does
google-analyticsAnalyzes live GA4 acquisition, engagement, pages, events, and conversions and safely manages supported measurement configuration.
search-consoleAnalyzes live Search Console queries and pages, inspects URLs, and manages approved sitemap submissions.

WordPress

SkillWhat it does
wordpressOperates connected WordPress sites: content, media, comments, design, settings, plugins, themes, and approved HTML or admin changes.

CRM

SkillWhat it does
gohighlevelOperates connected GoHighLevel contacts, conversations, opportunities, calendars, and other approved CRM changes.

Cross-model review and maintenance

SkillWhat it does
geminiUses Google Gemini for a second opinion, adversarial challenge, or open consultation.
upgradeUpdates an installed NotFair plugin and summarizes what changed.

Live data and integrations

Some skills work entirely from a repository, URL, or supplied export. Live account analysis uses one OAuth-connected universal NotFair MCP. The plugin registers exactly one server named NotFair, shared by every supported platform.

The agent chooses tools from the live server's instructions and capability descriptions. Skills supply marketing workflows and evidence standards without hardcoding MCP tool names or call sequences. See the connection and upgrade guide for manual configuration and migration from older per-platform connections. Each platform becomes available after it is connected in the NotFair workspace selected during OAuth. Follow any account setup guidance returned by the server.

Data sourceUsed forConnection
Google Search ConsoleSearch performance, queries, pages, indexing, URL inspection, and sitemapsOne NotFair connection
Google Analytics 4Acquisition, engagement, landing pages, events, conversions, realtime, and measurement configurationOne NotFair connection
Google AdsCampaign performance, search terms, bids, budgets, keywords, and change historyOne NotFair connection
Meta AdsFacebook and Instagram campaigns, ad sets, creatives, and insightsOne NotFair connection
X AdsCampaigns, line items, performance, targeting, promoted posts, audiences, and approved mutationsOne NotFair connection
LinkedIn AdsCampaign groups, campaigns, creatives, analytics, targeting, conversions, and leadsOne NotFair connection
Reddit AdsCampaigns, ad groups, ads, reporting, audiences, pixels, funding instruments, and approved mutationsOne NotFair connection
TikTok AdsAdvertiser delivery, reporting, creative, targeting, and approved mutationsOne NotFair connection
WordPressConnected site content, media, comments, design, settings, plugins, themes, and approved mutationsOne NotFair connection
GoHighLevelContacts, conversations, opportunities, calendars, and approved CRM mutationsOne NotFair connection
Other CMS platformsLocal SEO-script content review in Strapi, Contentful, or Ghostsetup-cms Application Password / API token, not NotFair MCP
Google GeminiCross-model reviewGemini API key

Supported account operations come from the live connection. Changes must stay within the user's authorization and be verified against the resulting account state. Amazon and ChatGPT Ads remain planning or export-review workflows unless the current agent session exposes a verified connector. setup-cms is a local SEO-script credential wizard; live WordPress work uses /notfair:wordpress.

Privacy and support

The plugin connects to the declared NotFair MCP endpoint through browser OAuth. Requested tool arguments go to NotFair and results from connected providers return to your authorized AI client. See the privacy policy for storage, retention, and deletion details. Connect only the workspace and platform accounts you intend to use.

Optional local workflows run readable Python or shell scripts. Crawlers request the URLs you supply; direct Search Console scripts use your explicitly authorized Google Cloud login; CMS scripts use the site credentials you configure through setup-cms. Gemini review sends the selected review context to Google's Gemini CLI after its authentication setup. Choose these workflows explicitly, keep credentials out of reports and commits, and use the OAuth MCP for live platform work when it is available. There are no automatic plugin hooks or local MCP servers. The calendar viewer serves local planning data on loopback, and the optional update checker reads the public version file from GitHub.

The separate NotFair Next.js blog library now lives in its own public repository and is distributed through its GitHub releases. Its source and publishing workflow are no longer bundled in this AI-agent plugin. The retired NotFair CMO application is also no longer included.

Inside a skill, connectors use tool-agnostic placeholders such as ~~google-ads, ~~meta-ads, ~~x-ads, ~~linkedin-ads, ~~reddit-ads, ~~tiktok-ads, ~~search-console, ~~google-analytics, ~~wordpress, and ~~gohighlevel. The agent resolves each placeholder to a compatible tool available in the current session, so the workflow is not coupled to one MCP namespace.

How the repository is organized

text
notfair-plugin/├── AGENTS.md                    # intent-to-skill resolver for AI agents├── .claude-plugin/              # Claude Code plugin manifest├── paid-ads/                    # cross-channel planning, review, optimization├── google-ads/                  # audit, management, copy, assets, landing pages├── meta-ads/                    # audit, management, creative├── analytics/                   # Google Analytics and Search Console MCP workflows├── wordpress/                   # live WordPress MCP operator├── gohighlevel/                 # live GoHighLevel CRM MCP operator├── seo/                         # SEO, GEO, content, and technical-search skills├── gemini/                      # cross-model review├── test/                        # unit and LLM-judge evals└── skills/                      # shared entry points for every agent host

AGENTS.md is the universal entry point. It maps user intent to the canonical SKILL.md and documents the external dependency each workflow requires.

Contributing

Each skill lives in its own category folder:

text
seo/your-skill-name/├── WORKFLOW.md       # full instructions and frontmatter├── references/       # optional supporting knowledge└── scripts/          # optional deterministic tooling

When adding or changing a skill:

  1. Keep the workflow focused on one clear marketing job.
  2. Use imperative, testable instructions in WORKFLOW.md, and keep the entry point under skills/ in sync.
  3. Add or update eval coverage.
  4. Update AGENTS.md, the plugin manifest, VERSION, and CHANGELOG.md.

Open a pull request with one skill or one coherent improvement. See plugin development for repository conventions.

Community

License

MIT

來源：README.md，提交 ed835f2

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v0.2.23最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Adsagent 整合

AdsAgent — Google Ads MCP

md.adsagent官方發布者

託管的 Google Ads MCP，讓助理以 OAuth 授權讀取廣告帳戶資料，並以先準備後確認的方式執行寫入。

Streamable HTTP可網頁執行驗證方式
資料與分析需要憑證Oct 24, 2026

AdsAgent — TikTok Ads MCP

md.adsagent官方發布者

託管的 TikTok 廣告 MCP 伺服器，讓助理透過 OAuth 以有界讀取方式查看廣告資料，並以準備/確認流程執行寫入。

Streamable HTTP可網頁執行驗證方式
商業與電商需要憑證Oct 24, 2026

AdsAgent — Meta Ads MCP

md.adsagent官方發布者

一個託管的 Meta 廣告 MCP 伺服器，讓助理在 OAuth 下讀取廣告資料並準備與確認廣告變更。

Streamable HTTP可網頁執行驗證方式
商業與電商需要憑證Oct 24, 2026