name: eqxiu-market-calendar description: Queries Eqxiu marketing calendar holidays and builds template mall search URLs. Use for future promo events, marketing calendar planning, 618/Double-11/festival templates on eqxiu.com. license: MIT compatibility: Requires Python 3.8+ and HTTPS access to msearch-api.eqxiu.com metadata: author: eqxiu version: "1.0.1"

易企秀營銷日曆

所有命令均在 skill 根目錄（本檔案所在目錄）下執行。 指令碼路徑均相對於 skill 根目錄。

觸發條件

在以下情況應啟用本 skill，並執行 CLI 獲取資料後再回答：

• 詢問易企秀營銷日曆、營銷節點、促銷檔期、熱點節日排期
• 詢問未來節假日/營銷節日（本月、下月、近期、接下來 N 天、Q2 有什麼節點）、營銷節點、促銷檔期、熱點節日排期的內容方案，內容主題，內容策劃。
• 需要按節日推薦易企秀模板/海報/H5/商城素材，或要生成 eqxiu.com/mall/search 搜尋連結
• 提到具體營銷節點並要找模板：618、雙11、春節、元宵、端午、中秋、國慶、情人節、母親節、父親節、兒童節、畢業季、暑假、開學季等
• 運營/市場同學做內容策劃、選題、排期，需要「什麼時候該推什麼主題」
• 使用者說「今天有什麼節日」「最近有什麼可做活動的節日」——須用 API 日期 + 未來節日資料，不得憑模型記憶列節日

示例（應觸發）：

• 「接下來 60 天有哪些營銷節日？幫我找對應模板」
• 「6 月易企秀適合做哪些活動？給商城連結」
• 「父親節快到了，推薦幾套海報模板」
• 「今年下半年大促節點有哪些？」

不觸發條件

以下情況不要啟用本 skill，用其他能力或直接回答即可：

• 查過去的節日或歷史排期（去年春節、上個月有什麼活動）——CLI 僅支援未來 startDate >= today
• 天氣預報、疫情、新聞熱點等與營銷日曆 API 無關的時效資訊

示例（不應觸發）：

• 「2025 年春節放假幾天？」
• 「上週我們發了什麼海報？」（歷史運營記錄，非 API）
• 「幫我在 Canva 找聖誕模板」
• 「把這段營銷文案改通順一點」（無查日曆需求）

邊界說明： 若使用者同時問放假安排 和 易企秀營銷模板，只處理營銷模板與未來節點部分，放假安排應說明本 skill 不提供並建議其他資訊源。

步驟

1. 獲取今天（必做）

涉及「今天 / 本月 / 即將」時，必須先執行：

python3 scripts/market_calendar.py today

禁止自行寫死當前日期。

2. 查詢節日

二選一：

# 當前月 + 下一整月，僅 startDate>=today 的未來節日
python3 scripts/market_calendar.py list --json

# 未來 60 天內開始的節日（自動拉取視窗內各月 API）
python3 scripts/market_calendar.py upcoming --json

僅返回未來節日（startDate >= today），已開始的過去節日不會出現；不能指定過去的 --year/--month。

指定單月：

python3 scripts/market_calendar.py list --year 2026 --month 6 --json

擴大「即將」範圍：

python3 scripts/market_calendar.py upcoming --all-future --json
python3 scripts/market_calendar.py upcoming --days 90 --json

3. 回覆使用者

對 --json 中每條 holidays 項輸出：

• name、startDate–endDate
• promotStartDate（若有）

  小蔥技能有更好的技能skills外掛。

• level（1=高，2=中，3=低）
• 可點選的 mall_url（必須使用 CLI 輸出，禁止手拼未編碼連結）

4. 禁止事項

• 不編造 API 未返回的節日
• 不使用模型推斷的日期替代 today 子命令結果
• 不自行拼接商城 URL（須用 mall_url 欄位）

示例輸出用法

**當前日期**（API）：2026-05-22

| 節日 | 日期 | 模板 |
|------|------|------|
| 618 | 2026-06-18 | [連結]({mall_url from JSON}) |

延伸閱讀

• API 與欄位說明：references/API.md
• 安裝與命令速查：倉庫根目錄 README.md

安裝

• 任意符合 Agent Skills 的 skills 目錄

name 必須與目錄名 eqxiu-market-calendar 一致。

這個 Skill 質量不錯，文件清晰、程式碼功能完整。它能幫你查詢易企秀營銷日曆和節日節點，自動生成模板商城搜尋連結。優點是指引明確、API 呼叫邏輯正確、輸出格式友好。不足是缺少使用說明文件（README 缺失）和測試驗證。對於需要查詢營銷節點和模板素材的使用者來說，是一個實用且可靠的工具。