Social Perks

io.github.benzatkulak-collab由 GitHub 帳號 benzatkulak-collab 發布v0.1.0更新於 Oct 24, 2026

Agent-native marketing platform: create campaigns, submit proofs, review submissions.

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

一個遠端行銷平台伺服器，讓助理為行銷動作定價、建立並啟動活動、提交證明並審核提交內容。

可以做什麼
查詢行銷動作的市場價格與依業務類型劃分的產業基準，並可依平台、類型與投入程度篩選列出可用的行銷動作。依平台與粉絲數搜尋網紅。列出某商家的活動，並建立與啟動新活動，回傳活動 ID、名稱與儀表板連結。以公開連結、截圖、影片或平台驗證資料的形式提交活動動作的完成證明。審核、核准或拒絕提交，依狀態列出提交，並讀取單一活動的統計，如核准數、轉換率與已發放權益。
適用情境
適合助理協助商家端到端規劃與執行社群行銷活動：為動作定價、挑選網紅、啟動活動、收集證明並審核提交。也適合向使用者回報活動成效。
執行需求
遠端 streamable HTTP 端點 socialperks.app，無需安裝套件。部分工具（如列出活動）需要身分驗證，但清單未宣告驗證方式、環境變數或請求標頭。
安裝前請注意
建立活動會立即上線，沒有獨立的發布步驟。核准提交會發放權益，拒絕提交必須提供理由。提交的證明可能包含公開貼文連結、截圖或影片並傳送至該平台。活動與提交資料綁定至呼叫方商家，寫入前應確認所用帳號。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Social Perks，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "social-perks": {
      "type": "http",
      "url": "https://socialperks.app/api/mcp"
    }
  }
}

README

Social Perks

The Marketing Value Protocol — AI-powered marketing infrastructure for every business.

107 marketing actions across 15 platforms. Pricing oracle for AI agents. Campaign execution layer.

Quick Start

bash
npm installnpm run dev

Open http://localhost:3000.

Demo Accounts

All use PIN: 1234

EmailBusiness Type
[email protected]Yoga Studio
[email protected]Restaurant
[email protected]Salon
[email protected]Gym
[email protected]Coffee Shop
[email protected]Tattoo Parlor
[email protected]Veterinarian
[email protected]Florist
[email protected]Law Firm
[email protected]Auto Mechanic

Or sign up as any business type — the AI adapts.

Tech Stack

  • Next.js 15 (App Router)
  • React 19
  • TypeScript
  • Tailwind CSS
  • Instrument Serif + DM Sans + JetBrains Mono

Using with Claude Code

This project includes a CLAUDE.md file that gives Claude Code full context about the architecture, design system, and what needs building next. Just run:

bash
claude

in the project directory and Claude will understand the full codebase.

License

Proprietary. All rights reserved.

來源：README.md，提交 f1e4fb0

工具

10

getPricing

Get the market-rate pricing for a marketing action. Returns USD value and recommended perk type/value.

輸入參數actionIdplatformIdbusinessType

listActions

List the 125 marketing actions available on Social Perks. Filterable by platform, type, and effort.

輸入參數pagetypeperPagemaxEffortplatformId

getBenchmarks

Get industry benchmarks (engagement rate, conversion rate, etc.) for a business type.

輸入參數businessType

listCampaigns

List campaigns. Requires auth — returns the caller's campaigns.

輸入參數status

searchInfluencers

Search influencers by platform and follower count.

輸入參數platformminFollowers

createCampaign

Create and launch a new campaign for the calling business. Returns the campaign id, name, and dashboard URL. The campaign goes live immediately — no separate publish step.

輸入參數name必填actions必填businessId必填descriptiondiscountType必填discountValue必填expiresInDaysmaxCompletions

submitProof

Submit proof of completion for a campaign action — a public URL to a post, a screenshot, a video, or platform-verified data. The submission enters a review queue (or auto-approves depending on the campaign's verification mode).

輸入參數actionId必填metadataproofUrl必填proofType必填campaignId必填

reviewSubmission

Approve or reject a submission. Approving releases the perk; rejecting requires a reason. Use this when the business chooses manual review over auto-verification.

輸入參數reasondecision必填submissionId必填

listSubmissions

List submissions for a business or campaign, filterable by state (pending/approved/rejected). Returns paginated results.

輸入參數pagestateperPagebusinessIdcampaignId

getCampaignStats

Get summary stats for a single campaign — total submissions, approved count, conversion rate, perks issued, and time-to-first-submission. Useful for an agent reporting back to its user.

輸入參數campaignId必填

版本歷史

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

評分

已滿足適用檢查項的 90%

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

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。