Synter Ads

ทางการ

การจัดการแคมเปญโฆษณาข้ามแพลตฟอร์มสำหรับเอเจนต์ AI บน Google, Meta, LinkedIn, Reddit, TikTok และอื่นๆ อีกมากมาย พร้อมเครื่องมือมากกว่า 140 รายการที่สามารถอ่านและเขียนได้

คุณทำอะไรได้บ้างด้วย Synter Ads MCP?

  • รายงานประสิทธิภาพข้ามแพลตฟอร์ม — สอบถามค่าใช้จ่าย การแสดงผล การคลิก คอนเวอร์ชัน CPA และ ROAS แยกตามแพลตฟอร์ม แคมเปญ และวัน จากบัญชีโฆษณาที่เชื่อมต่อ
  • ตรวจสอบการใช้จ่ายตามงบประมาณ — ตรวจสอบการใช้จ่ายตามงบประมาณรายเดือนในแพลตฟอร์มที่เชื่อมต่อ และแจ้งเตือนแคมเปญที่ใช้จ่ายเกินงบ
  • เปลี่ยนแปลงแคมเปญพร้อมทดลองรัน — ดูตัวอย่างแคมเปญใหม่หรือการเปลี่ยนแปลงงบประมาณด้วย dry_run: true ก่อนสร้างแคมเปญในสถานะ PAUSED
  • หยุดแคมเปญและอัปเดตงบประมาณ — หยุดแคมเปญหรือเปลี่ยนงบประมาณแคมเปญใน Google, Meta, LinkedIn, Microsoft, Reddit และแพลตฟอร์มหลักอื่น ๆ
  • จัดการคีย์เวิร์ดเชิงลบ — เพิ่มคีย์เวิร์ดเชิงลบในระดับแคมเปญ กลุ่มโฆษณา รายการที่ใช้ร่วมกัน หรือบัญชีใน Google Ads
  • เขียนผลลัพธ์ลงใน Google Sheet — ให้เอเจนต์เขียนค่าใช้จ่ายรายสัปดาห์แยกตามแพลตฟอร์มลงใน Google Sheet สำหรับรายงาน

เอกสาร

Synter MCP Server (@synterai/mcp-server@1.4.6)

MCP server แบบโอเพนซอร์สสำหรับใช้ AI agent จัดการโฆษณาบนแพลตฟอร์มโฆษณากว่า 30 แพลตฟอร์ม: อ่านข้อมูลฟรี ($0.00/เดือน), Solo ราคา $20/เดือน (รวมมูลค่าการใช้งาน $20/เดือน; การเขียนข้อมูล $0.05-$0.25), ไม่คิดค่าบริการตามยอดใช้จ่ายโฆษณา

npm version License: MIT Add Synter to Amp

เชื่อมต่อ AI coding agent (Claude Code, OpenAI Codex, Cursor, Windsurf, Amp, Gemini CLI) กับ แพลตฟอร์มโฆษณากว่า 30 แพลตฟอร์ม ผ่าน MCP แบบโฮสต์ (https://mcp.synterai.com) และ REST API (https://synterai.com/api/v1/tools/run) หรือเรียกใช้ในเครื่องผ่าน stdio (npx -y @synterai/mcp-server@1.4.6) บน แพลตฟอร์มโฆษณาหลัก 16 แพลตฟอร์มที่รองรับการอ่านและเขียนเต็มรูปแบบ (Google Ads, Meta, LinkedIn, Microsoft/Bing, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, OpenAI Ads, Google DV360 และ StackAdapt)

ควรใช้เมื่อใด

ใช้ Synter เมื่อผู้ใช้ต้องการรายงานโฆษณาข้ามแพลตฟอร์ม ค่าใช้จ่าย/ROAS/CPA แยกตามช่องทาง สรุปสื่อแบบชำระเงินรายสัปดาห์ หรือการเปลี่ยนแปลงแคมเปญและงบประมาณที่มีการกำกับดูแล ครอบคลุม search, social, retail media, audio และ programmatic DSP เริ่มจากเครื่องมืออ่านข้อมูล โดยไม่ต้องเขียนข้อมูล

"Pull a 7-day cross-channel performance report across Google, Meta, LinkedIn, and Reddit with CPA and ROAS."
"Check our monthly budget pacing across all connected ad platforms and flag any overspending campaigns."
"Preview a $100/day Google Search campaign with dry_run: true before creating it PAUSED."

ใช้เป็นตัวเชื่อมต่อข้อมูลโฆษณา

หากต้องการนำข้อมูลโฆษณาเข้าสู่ AI assistant หรือโค้ดของคุณเอง Synter คือตัวเชื่อมต่อ: เชื่อมต่อบัญชีโฆษณาแต่ละบัญชีเพียงครั้งเดียว จากนั้นสอบถามค่าใช้จ่าย การแสดงผล การคลิก คอนเวอร์ชัน CPA และ ROAS แยกตามแพลตฟอร์ม แคมเปญ และวันได้

  • ข้อมูลจะไปที่ใด: Claude, Claude Code, Cursor, Codex, ChatGPT หรือ MCP client ใดก็ได้ (MCP แบบโฮสต์ที่ https://mcp.synterai.com) หรือโค้ดของคุณเองผ่าน REST endpoint POST https://synterai.com/api/v1/tools/run และ SDK นอกจากนี้ agent ยังเขียนผลลัพธ์ลงใน Google Sheet ได้เมื่อใช้ MCP แบบโฮสต์ (update_google_sheet)
  • แพลตฟอร์มที่อ่านข้อมูลได้: Google Ads, Meta (Facebook & Instagram), LinkedIn, Microsoft Ads, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, DV360, CM360, Criteo, Walmart Connect, Instacart, Target Roundel, FreeWheel และ OpenAI Ads (เครื่องมือ MCP แบบโฮสต์ pull_*_performance) แพ็กเกจ npm ในเครื่องรองรับชุดหลักผ่าน list_campaigns, get_performance และ get_daily_spend
  • ค่าใช้จ่าย: อ่านข้อมูลจากบัญชีของคุณเองได้ฟรี ($0.00, 0 เครดิต); แพ็กเกจจำกัดจำนวนที่นั่งและ workspace (ดู Pricing)
  • ความใหม่ของข้อมูล: การอ่านข้อมูลจะเรียก API ของแต่ละแพลตฟอร์มโดยตรง ณ เวลาที่ร้องขอ ไม่ต้องรอการซิงก์ข้ามคืน
  • แยกตามลูกค้า: เอเจนซีเก็บข้อมูลลูกค้าแต่ละรายไว้ใน workspace ของตนเอง เพื่อไม่ให้รายงานปะปนบัญชีกัน
  • นอกเหนือจากการรายงาน: การเชื่อมต่อเดียวกันนี้ใช้หยุดแคมเปญ เปลี่ยนงบประมาณ และเพิ่มคีย์เวิร์ดเชิงลบได้ โดยต้องมีการอนุมัติและทดลองรันก่อน ตัวเชื่อมต่อที่ใช้รายงานอย่างเดียวทำไม่ได้
  • กรณีที่ควรใช้เครื่องมืออื่น: หากต้องการนำข้อมูลโฆษณาไปเก็บใน BigQuery หรือ Snowflake ตามกำหนดเวลาเพื่อใช้กับ BI dashboard ให้ใช้เครื่องมือ warehouse ELT แทน Synter อ่านข้อมูลสดเข้าสู่ agent โดยไม่โหลดข้อมูลเข้า warehouse
"Connect our Google Ads, Meta and LinkedIn accounts and show last month's spend and cost per lead by channel."
"Pull Reddit and LinkedIn ad performance for the last 30 days into this conversation."
"Write this week's spend by platform into our reporting Google Sheet."

เริ่มต้นอย่างรวดเร็ว (Sandbox ที่ไม่ต้องใช้ข้อมูลรับรองใน 30 วินาที)

ทดลองใช้ Synter ได้ทันทีโดยไม่ต้องใช้ API key หรือบัตรเครดิต พร้อมการตอบกลับจาก sandbox ที่ให้ผลลัพธ์แน่นอน:

# 1. Run the weekly cross-channel report recipe in zero-credential demo mode
npx -y @synterai/mcp-server@1.4.6 --help
node examples/weekly-report/generate-report.mjs

# 2. Or register in Claude Code (Hosted OAuth 2.1 — all 30+ platforms)
claude mcp add --transport http synter-ads https://mcp.synterai.com

# 3. Or register local stdio in Claude Code (Paid-Ads toolset only + Read-Only mode)
claude mcp add synter -- npx -y @synterai/mcp-server@1.4.6 --toolset ad-ops --read-only

ตั้งค่าไคลเอนต์

  • Amp: มีมาให้ในตัว (Settings > Integrations) หรือใช้วิธีสำรอง "amp.mcpServers" ด้านล่าง
  • Claude Code:
    • Hosted HTTP (OAuth 2.1): claude mcp add --transport http synter-ads https://mcp.synterai.com
    • Local stdio: claude mcp add synter -e SYNTER_API_KEY=syn_your_key -- npx -y @synterai/mcp-server@1.4.6
  • OpenAI Codex:
    • codex mcp add synter-ads --url https://mcp.synterai.com
  • Claude.ai / Claude Desktop:
    • ไปที่ Settings -> Connectors -> Add custom connector แล้วกรอก https://mcp.synterai.com
  • ChatGPT:
    • MCP connector แบบกำหนดเองต้องเปิดใช้ Developer mode (Settings -> Apps & Connectors -> Advanced -> Developer mode) ก่อน จากนั้นเพิ่ม https://mcp.synterai.com
  • Cursor / Windsurf (mcp.json):
    {
      "mcpServers": {
        "synter": {
          "command": "npx",
          "args": ["-y", "@synterai/mcp-server@1.4.6"],
          "env": {
            "SYNTER_API_KEY": "${SYNTER_API_KEY}"
          }
        }
      }
    }
    
  • Gemini CLI:
    • gemini extensions install https://github.com/Synter-Media-AI/mcp-server

เพิ่ม Synter ใน Amp

  1. ใน Amp: Synter เป็น integration ที่มีมาให้ในตัว เปิดใช้งานใน Amp ที่ Settings > Integrations
  2. Claude, ChatGPT และ MCP client อื่น ๆ แบบโฮสต์ (แพลตฟอร์มโฆษณากว่า 30 แพลตฟอร์ม, Agentic DSP เพียงรายเดียว): https://mcp.synterai.com
  3. แบบอ่านอย่างเดียวในเครื่อง (แพ็กเกจ npm):
    {
      "amp.mcpServers": {
        "synter": {
          "command": "npx",
          "args": ["-y", "@synterai/mcp-server@1.4.6", "--toolset", "ad-ops", "--read-only"],
          "env": {
            "SYNTER_API_KEY": "${SYNTER_API_KEY}"
          }
        }
      }
    }
    

ชุดเครื่องมือ โหมดอ่านอย่างเดียว และโหมดสาธิต

Flag / Environment Variableการทำงาน
ค่าเริ่มต้น (full)แสดง เครื่องมือ stdio โดยตรงทั้งหมด 56 รายการ (เครื่องมือโฆษณาแบบชำระเงิน 32 รายการบนแพลตฟอร์มหลัก + เครื่องมือโซเชียลออร์แกนิก 8 รายการ *_organic_post + เครื่องมือขาออก 16 รายการ prospector_*)
--toolset ad-ops (SYNTER_TOOLSET=ad-ops)แสดง เฉพาะเครื่องมือโฆษณาแบบชำระเงินหลัก 32 รายการ และนำเครื่องมือโซเชียลออร์แกนิกและขาออกทั้งหมดออกจาก tools/list (และปฏิเสธการเรียกใช้)
--read-only (SYNTER_READ_ONLY=true)แสดง เฉพาะเครื่องมืออ่านอย่างเดียว (readOnlyHint: true) ใน tools/list และบล็อกเครื่องมือที่เปลี่ยนแปลงข้อมูลทั้งหมด (destructiveHint: true) ในเครื่องก่อนเรียกเครือข่าย
--demo (SYNTER_DEMO=true)ทำงานในโหมด sandbox ที่ไม่ต้องใช้ข้อมูลรับรอง พร้อมข้อมูลแคมเปญและประสิทธิภาพหลายแพลตฟอร์มที่สมจริงและผ่านการปรับรูปแบบแล้ว (sandbox: true)

ความครอบคลุมของแพลตฟอร์มและตารางความสามารถในการอ่าน/เขียน (Hosted / Local Stdio)

MCP แบบโฮสต์ (https://mcp.synterai.com) และ REST endpoint (POST https://synterai.com/api/v1/tools/run) ครอบคลุม แพลตฟอร์มโฆษณากว่า 30 แพลตฟอร์ม แพ็กเกจ stdio ในเครื่อง (@synterai/mcp-server@1.4.6) รองรับ enum platform แบบมีชนิดข้อมูลโดยตรงบน แพลตฟอร์มหลักที่รองรับการอ่านและเขียนเต็มรูปแบบ และเข้าถึงสคริปต์ backend กว่า 140 รายการผ่าน run_tool:

แพลตฟอร์ม (enum platform)เครื่องมืออ่านข้อมูลโดยตรง ($0.00)เครื่องมือเขียนข้อมูลโดยตรง + สคริปต์ run_tool (SOLO / SCALE / CUSTOM)
Google Ads (google)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, run_tool(script_name="run_gaql_query" | "get_ad_readback")create_search_campaign, create_display_campaign, create_pmax_campaign, pause_campaign, update_campaign_budget, add_keywords, add_negative_keywords (BROAD, PHRASE, EXACT ในระดับแคมเปญ/กลุ่มโฆษณา/รายการที่ใช้ร่วมกัน/บัญชี), create_conversion, manage_audience, sync_audience, upload_image
Meta Ads (meta)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetcreate_meta_campaign, pause_campaign, update_campaign_budget, stage_audience_artifact, sync_audience, upload_image, run_tool(script_name="meta_ads_create_ad_set" | "meta_ads_create_ad")
LinkedIn Ads (linkedin)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetcreate_linkedin_campaign (ต้องใช้ group_id), pause_campaign, update_campaign_budget, sync_audience, upload_image, run_tool(script_name="linkedin_ads_create_campaign_group")
Microsoft / Bing Ads (microsoft)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="microsoft_ads_create_campaign" | "microsoft_ads_add_keywords" | "microsoft_ads_add_negative_keywords")
Reddit Ads (reddit)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetcreate_reddit_campaign, pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="reddit_ads_create_ad_group" | "reddit_ads_create_ad")
TikTok Ads (tiktok)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="tiktok_ads_create_campaign" | "tiktok_ads_update_adgroup")
X Ads (x)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="x_ads_create_campaign" | "x_ads_create_line_item")
Pinterest Ads (pinterest)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="pinterest_ads_create_campaign" | "pinterest_ads_create_ad_group")
Snapchat Ads (snapchat)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="snapchat_ads_create_campaign" | "snapchat_ads_create_ad_squad")
Spotify Ads (spotify)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="spotify_ads_create_campaign" | "spotify_ads_create_ad_set")
Amazon Ads (amazon_ads)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="amazon_ads_create_campaign" | "amazon_ads_add_keywords")
Amazon DSP (amazon_dsp)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="amazon_dsp_create_order" | "amazon_dsp_create_line_item")
The Trade Desk (the_trade_desk)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="ttd_create_campaign" | "ttd_create_ad_group")
OpenAI Ads (openai)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="openai_ads_create_campaign")
Google DV360 (dv360)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, run_tool(script_name="dv360_create_campaign" | "dv360_create_insertion_order" | "dv360_create_line_item")
StackAdapt (stackadapt)list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budgetpause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="create_stackadapt_campaign")
แพลตฟอร์มเพิ่มเติม (Hosted MCP และ run_tool)run_tool(script_name="<platform>_*") ใน stdio; pull_*_performance / execute โดยตรงบน https://mcp.synterai.comCM360, Walmart Connect, Instacart, Target Roundel, Criteo, FreeWheel, SA360, Apple Ads, Demandbase ABM, Taboola, Outbrain, AppLovin, Yahoo DSP, Teads, Viant, Basis, MediaMath, Magnite, PubMatic, Index Exchange, TripleLift, GumGum, Dianomi, Quora Ads, Nextdoor Ads, Twitch Ads, Yelp Ads, Samsung Ads, Roku Ads, impact.com

ราคา (คิดเป็น USD 100% — ไม่คิดค่าบริการตามยอดใช้จ่ายโฆษณา)

Synter ไม่คิดค่าบริการตามยอดใช้จ่ายโฆษณา (เครือข่ายโฆษณาเรียกเก็บค่าใช้จ่ายสื่อโดยตรง) และ ไม่คิดค่าใช้จ่ายสำหรับการอ่านข้อมูลจากบัญชีของคุณเองและการแสดงตัวอย่าง dry_run: true ทั้งหมด ดูรายละเอียดทั้งหมดที่ https://synterai.com/pricing:

แพ็กเกจราคาที่นั่งและ Workspaceมูลค่าการใช้งานรายเดือนที่รวมและอัตราค่าบริการเขียนข้อมูล
สิทธิ์อ่านข้อมูลฟรี$0.00 / เดือน1 ที่นั่ง, 1 workspace$0.00 สำหรับการค้นหาข้อมูลอ่านจากบัญชีของคุณเองทั้งหมด (list_campaigns, get_performance, get_daily_spend, pacing_report, user_budget_pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, list_landing_pages, inspect_agent_shield, verify_angstrom_claim, get_skill, get_llm_visibility, run_gaql_query, get_ad_readback, get_solo_price_card, get_credit_balance) และการแสดงตัวอย่าง dry_run: true ทั้งหมด ไม่ต้องใช้บัตรเครดิต
SOLO$20.00 / เดือน ($200.00 / year)1 ที่นั่ง, 1 workspaceรวมมูลค่าการใช้งานที่ขอรับได้ $20.00/เดือน — ใช้ได้กับการเขียนข้อมูลแบบเบาสูงสุด 400 ครั้ง ($0.05 ต่อครั้ง: pause_campaign, enable_campaign, update_campaign_budget), การเขียนข้อมูลมาตรฐาน 80 ครั้ง ($0.25 ต่อครั้ง: add_keywords, add_negative_keywords, sync_audience, create_conversion) หรือ การเปิดตัวแคมเปญ MCP เต็มรูปแบบ 4 ครั้ง ($5.00 ต่อครั้ง) กำหนดเพดานค่าใช้จ่ายสูงสุดได้ เพื่อป้องกันค่าใช้จ่ายส่วนเกินที่ไม่คาดคิด
SCALE$500.00 / เดือน ($5,000.00 / year)5 ที่นั่ง, หลาย workspaceรวมมูลค่าการใช้งานที่ขอรับได้ $500.00/เดือน (รวมการเขียนข้อมูลแบบเบาสูงสุด 10,000 ครั้ง หรือการเขียนข้อมูลมาตรฐาน 2,000 ครั้ง/เดือน) พร้อมการแยกลูกค้าระหว่างหลาย workspace, กำหนดเวลา Autonomous Loop / Autopilot ตลอด 24/7, การซิงก์ CRM/warehouse และการประมวลผลพร้อมกันแบบเฉพาะ
CUSTOMสัญญาองค์กรจำนวนที่นั่งและ workspace กำหนดเองโควต้าการใช้งานรายเดือนที่กำหนดเอง การจัดการหลาย workspace สำหรับเอเจนซี/องค์กร SLA ที่กำหนดเอง SSO และการเรียกเก็บเงินตามใบแจ้งหนี้

แนวทางด้านความปลอดภัย มาตรการป้องกันการเขียนข้อมูล และสถาปัตยกรรมแบบหลายผู้เช่า

การป้องกันการเขียน 4 ชั้น

  1. โหมดอ่านอย่างเดียวแบบเข้มงวดในเครื่อง (--read-only / SYNTER_READ_ONLY=true): นำเครื่องมือ destructiveHint: true ทั้งหมดออกจาก tools/list และบล็อกการเปลี่ยนแปลงในเครื่องก่อนที่คำขอใด ๆ จะออกจากเครื่องของคุณผ่านเครือข่าย
  2. คีย์ API แบบจำกัดขอบเขตที่บังคับใช้โดยเซิร์ฟเวอร์ (POST /api/v1/keys): สร้างคีย์แบบอ่านอย่างเดียว (reporting:read, campaigns:read, intel:read) หรือคีย์ความปลอดภัยแบบกำหนดทิศทาง (budget:decrease — อนุญาตให้หยุดแคมเปญฉุกเฉินและลดงบประมาณ แต่ปฏิเสธการเพิ่มงบประมาณด้วย HTTP 403)
  3. ด่านนโยบายฝั่งเซิร์ฟเวอร์ของ Agent Shield: บังคับใช้ค่าเริ่มต้น PAUSED-on-create สำหรับทุกแคมเปญใหม่ เพดานการเพิ่มงบประมาณต่อการเรียกใช้สูงสุด 2.0x ตัวตัดวงจรความเร็วของเวิร์กสเปซ $5,000/day การแสดงตัวอย่าง dry_run: true ($0.00) การอ่านข้อมูลกลับจากผู้ให้บริการหลังการเขียนที่บังคับใช้ (get_ad_readback) และบันทึกการตรวจสอบของเวิร์กสเปซที่แก้ไขไม่ได้
  4. การประมวลผลแบบ BYO-Credential ที่โฮสต์เองและเป็นโอเพนซอร์ส MIT: เรียกใช้ @synterai/mcp-server@1.4.6 ภายใน VPC/คอนเทนเนอร์ของคุณเอง โดยส่งโทเค็น OAuth ของแพลตฟอร์มที่คุณเป็นเจ้าของโดยตรงผ่านตัวแปรสภาพแวดล้อม เพื่อให้คลาวด์ที่ Synter โฮสต์ไม่มีสิทธิ์ครอบครองข้อมูลรับรองบัญชีโฆษณาของคุณเลย

รูปแบบ SaaS แบบหลายผู้เช่าและแบบฝัง (docs.synterai.com/api/multi-tenant-auth)

  1. รูปแบบที่ 1 — คีย์และลิงก์เชื่อมต่อที่โฮสต์และแยกตามเวิร์กสเปซ:
    • สร้างคีย์ API ลูกที่กำหนดเวิร์กสเปซและจำกัดขอบเขตผ่าน POST https://synterai.com/api/v1/keys (scopes: ["reporting:read", "campaigns:read", "intel:read", "budget:decrease", "campaigns:write", "budget:write"], rate_limit_rpm: 1–600, expires_in_days)
    • สร้าง URL สำหรับส่งต่อ OAuth ของผู้ลงโฆษณาแบบบริการตนเองผ่าน POST https://synterai.com/api/v1/connections/start (ส่งคืน authUrl สำหรับแพลตฟอร์มเดียว) หรือ POST https://synterai.com/api/v1/connections/request (ส่งลิงก์เชื่อมต่อหลายแพลตฟอร์มที่มีอายุ 7 วันให้ลูกค้า)
    • สลับเวิร์กสเปซที่ใช้งานอยู่บนคีย์ที่ใช้ได้หลายเวิร์กสเปซผ่าน get_workspaces และ update_active_workspace
  2. รูปแบบที่ 2 — โหมด BYO-Credential แบบโฮสต์เอง (โอเพนซอร์ส MIT):
    • แอป SaaS แบบหลายผู้เช่าที่จัดการแอป OAuth ของตนเองและจัดเก็บโทเค็นลูกค้าใน KMS/คลังข้อมูลลับของตนเอง สามารถเรียกใช้ CLI @synterai/mcp-server หรือ synter ในโปรเซสเวิร์กเกอร์ที่แยกจากกัน โดยส่งโทเค็นแพลตฟอร์มของแต่ละผู้เช่าผ่านตัวแปรสภาพแวดล้อม (GOOGLE_ADS_REFRESH_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_DEVELOPER_TOKEN, META_ACCESS_TOKEN, LINKEDIN_ACCESS_TOKEN เป็นต้น)

REST API และ SDK อย่างเป็นทางการสำหรับหลายภาษา

  • MCP ที่โฮสต์ (Streamable HTTP): https://mcp.synterai.com — ยืนยันตัวตนผ่านการลงชื่อเข้าใช้ด้วยเบราว์เซอร์ OAuth 2.1 หรือส่วนหัว X-Synter-Key: syn_... อย่าส่ง Authorization: Bearer syn_... ไปยัง MCP ที่โฮสต์ในขณะนี้; REST/SDK ใช้ Bearer
  • REST Endpoint: POST https://synterai.com/api/v1/tools/run พร้อม Authorization: Bearer syn_... (หรือ X-Synter-Key: syn_...) และเนื้อความ JSON {"script_name": "<tool_or_script>", "args": ["--flag", "value"], "platform": "google"}
  • SDK TypeScript / JavaScript: npm install @synterai/sdk-js
  • SDK Python: pip install synter -> Synter(api_key=..., base_url=..., timeout=..., max_retries=...); เมตริกผ่าน client.analytics.get_performance(...)
  • SDK Rust: cargo add synter (crates.io/crates/synter)
  • SDK Java: Maven ai.syntermedia:synter-sdk

ใบอนุญาต

ใบอนุญาต MIT — ดู LICENSE.