Community影像github.com

F2-Beamer/stock-photo-metadata

用於準備上傳至 Adobe Stock 或 Shutterstock 貢獻者帳戶的照片時,為庫存照片生成標題、描述、類別或關鍵字,或為一批庫存圖像生成元數據 CSV 檔案。

stock-photo-metadata 是什麼?

此技能專為庫存攝影師設計,能自動為 Adobe Stock 和 Shutterstock 平台上的每張圖片生成英文元數據,包括標題、描述、類別和關鍵字。對於批量處理,它還能同時產生符合兩平台格式的 CSV 檔案。技能會先根據清晰的品質與法律標準(例如曝光、噪點、解析度、模糊、可見商標與人物等)審查並分類圖片,將合格的圖片移至「angenommen/」(已接受)資料夾,不合格的則移至「abgelehnt/」(已拒絕)資料夾,並附上拒收原因。接著,它會為每張接受的圖片產出指定的元數據格式,嚴格遵守平台字數限制與關鍵字數量上限。其獨特之處在於,它會參考同一目錄下的 `platform-rules.md` 檔案,以確保所有輸出(如類別清單、CSV 欄位和已知被拒的關鍵字)都符合最新規範,從而避免常見的上傳錯誤,例如 Adobe 不允許使用多個類別、CSV 中欄位引用不當,或關鍵字重複。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/F2-Beamer/stock-photo-metadata/tree/HEAD

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

庫存照片元數據

概述

為 Adobe Stock 和 Shutterstock 的每張圖片創建英文元數據:標題、描述、類別和關鍵字。若有多張圖片,還會額外生成一個 CSV 檔案。對使用者的說明保留為德語,但元數據部分為英文。

平台相關數值(字元限制、關鍵字數量、類別清單、CSV 格式)記錄在同一目錄的 platform-rules.md 檔案中。每次輸出前都必須讀取該檔案。兩個平台的 CSV 格式均已通過成功上傳驗證。待釐清事項包括 Shutterstock 的描述字數限制以及被拒的關鍵字,詳細請參閱 platform-rules.md。

處理流程

  1. 檢視圖片。 記錄主要主體、情緒、顏色、地點、季節、時間、可見人物、品牌、商標、建築物及私有土地。
  2. 檢查授權文件。 檢查是否有可辨識的人物、品牌/商標、私有建築物或土地、藝術作品、AI 元素。若發現任何一項,請在輸出中加入相關提示。若有疑慮,切勿聲稱圖片無需授權。
  3. 撰寫標題。 具體、具描述性,避免贅詞,且除非已獲得授權,否則不得包含品牌名稱。
  4. 撰寫描述。 一至兩句話,描述主體與背景。保持在 Shutterstock 的字元限制內。
  5. 選擇類別。 對於 Adobe,從清單中選擇一個精確的編號與名稱。對於 Shutterstock,可從 platform-rules.md 的清單中選擇最多兩個類別。在 CSV 中,以小寫英文書寫,例如 nature,parks/outdoor。
  6. 選擇關鍵字。 最重要的優先。主體、物件、情緒、顏色、地點、季節、用途。避免重複,且不使用與圖片不相關的詞彙。

圖片審查與分類

根據需求,此技能會審查資料夾內的所有圖片,並將其移動至 angenommen/(已接受)與 abgelehnt/(已拒絕)子資料夾。流程如下:

  1. 列出資料夾根目錄下(不包含 angenommen/ 或 abgelehnt/ 子資料夾)的所有 JPG/JPEG/PNG 檔案。若子資料夾不存在,則建立它們。
  2. 檢視並評估每張圖片:
    • 拒絕,若符合以下任一情況:
      • 嚴重曝光不足或有雜訊,主體難以辨識
      • 可見的噪點(天空、陰影或區域中的顆粒感),即使亮度足夠
      • 低解析度:總像素低於 4 百萬像素(參考值,未經驗證)
      • 模糊或相機晃動
      • 未經授權的可見商標或品牌(例如卡車上的公司標誌)
      • 未經授權的可辨識人物、私有建築物、政府或軍事設施
      • 浮水印、圖片中的文字或嚴重偽影
    • 接受 在其他所有情況下。
    • 若有疑慮,歸類為「拒絕」並說明原因。由使用者最終決定。
  3. 每張圖片提供一句說明(德語)。
  4. 移動檔案,而非複製。若目標位置已有同名檔案,則不覆蓋,而是詢問使用者。
  5. 總結:接受與拒絕的數量,以及被拒絕的檔案清單與原因。

只有被接受的圖片才會進入元數據生成與 CSV 檔案。

每張圖片的輸出格式

**Dateiname:** <檔案名稱>

**Releases:** <提示或「未檢測到」>

**Adobe Stock**
- 標題: ...
- 類別: <編號> <名稱>
- 關鍵字: ...

**Shutterstock**
- 描述: ...
- 類別 1: ...
- 類別 2: ...
- 關鍵字: ...

批量圖片時的 CSV

在圖片所在的資料夾中生成兩個 CSV 檔案,使用 UTF-8 編碼。僅在欄位包含逗號時(例如關鍵字)才使用引號。檔案名稱、標題和類別永遠不使用引號。否則 Adobe 會讀取含有引號的檔案名稱,導致該行無法對應到任何圖片。

Adobe Stock:adobe-stock-upload.csv(分隔符為逗號,欄位順序嚴格如下,英文):

Filename,Title,Keywords,Category,Releases

  • Filename:包含副檔名的完整檔案名稱
  • Keywords:逗號分隔,最多 49 個,按相關性排列
  • Category:僅數字,例如 11
  • Releases:若無授權文件,則留空

Shutterstock:shutterstock-metadaten.csv(分隔符為逗號,格式符合 Shutterstock 範例檔案,已透過上傳驗證):

Filename,Description,Keywords,Categories,Editorial,Mature content,illustration

  • Categories:最多兩個,用引號括住並以逗號分隔,小寫英文,例如 "nature,parks/outdoor"
  • Editorial、Mature content、illustration:分別填入 no。不將未經授權的設施、建築物或財產圖片以 Editorial 形式提交作為替代方案;此類圖片會被拒絕(移至 abgelehnt/)。
  • 此格式中不包含 Release 欄位。Release 相關資訊僅在使用者提示中提及。

規則

  • 禁止幻覺:僅在可見或可明確辨識時,才提及地點、動物種類、樹木種類或品牌。否則使用通用描述。
  • 不使用僅反映趨勢或搜尋字詞但與圖片無關的關鍵字。
  • 避免關鍵字重複,且不使用「best」、「beautiful」、「amazing」等詞彙。
  • 嚴格遵守字元限制,完成後進行計數。
  • 關鍵字:每張圖片約 30 個。Shutterstock 會拒絕某些特定關鍵字。使用者將回報這些被拒的關鍵字,它們將被記錄在 platform-rules.md 的「Abgelehnte Keywords」(被拒關鍵字)區段。此後絕不再使用這些詞彙。
  • 即使不確定,也絕不隱瞞授權文件要求。

常見錯誤

錯誤修正方式
標題過長、關鍵字堆砌保持簡潔具體,關鍵字獨立列出
Adobe 使用超過一個類別僅使用一個類別
標題中包含品牌名稱刪除或提供 Release 提示
推測地點僅在可辨識時提及,否則使用「lake」、「mountain」等
憑記憶使用平台限制對照 platform-rules.md 檢查

相關技能