# Prompt library (https://sellersheetai.com/docs/start/prompts)

> Requests to copy into your agent — each with the tools it calls and whether it changes anything. Every prompt works in English and 中文.



Copy a request, swap in your own store and SKUs, and send it to your agent. Each one shows the tools it calls and its effect:

* <EffectBadge effect="read" /> changes nothing on Amazon — reading orders, stock, reports.
* <EffectBadge effect="write" /> changes your Amazon account — feeds, listings, shipments, ads. It needs write access on that store, or the call is refused.
* <EffectBadge effect="credits" /> is paid from your Credits balance, and refunded automatically if it fails.

## How your agent works with SellerSheet [#how-your-agent-works-with-sellersheet]

* It starts with `get_user_context`, which returns your store refs (like <StoreRef />). Every later call names the store and its marketplace that way.
* Every result carries a message your agent passes on to you, and a note when something needs you personally.
* Results go into the Google Sheet you name, with headers, formats and filters. Edit it there, then say "submit the rows I changed".

## Orders & finance [#orders--finance]

* "Pull the last 7 days of orders for myStore-US into a sheet, totalled by SKU — units and sales." <br />把 myStore-US 最近 7 天的订单拉到表格里，按 SKU 汇总销量和销售额 <br />`orders_searchOrders` <EffectBadge effect="read" />
* "Which fees did Amazon take on order 112-3456789-0000000?" <br />订单 112-3456789-0000000 亚马逊到底扣了哪些费用？ <br />`finances_listFinancialEventsByOrderId` <EffectBadge effect="read" />
* "What were revenue, refunds and FBA fees in the last settlement period?" <br />上一个结算周期的收入、退款、FBA 费用分别是多少？ <br />`finances_listFinancialEventGroups` · `finances_listFinancialEventsByGroupId` <EffectBadge effect="read" />
* "Send a review request to these delivered orders." <br />给这批已送达订单发送 Request a Review <br />`solicitations_getSolicitationActionsForOrder` · `solicitations_createProductReviewAndSellerFeedbackSolicitation` <EffectBadge effect="write" />

## Listings [#listings]

* "Put the title, bullets and A+ status of these 20 ASINs side by side in a sheet." <br />把这 20 个 ASIN 的标题、五点、A+ 状态拉下来做一张对比表 <br />`listings_fetch_attributes_by_asins` · `aplusContent_searchContentPublishRecords` <EffectBadge effect="read" />
* "Push the prices and stock for these 50 SKUs from my sheet to Amazon." <br />帮我把表格里这 50 个 SKU 的价格和库存批量更新到亚马逊 <br />`listings_submit_feed` <EffectBadge effect="write" />
* "Can I sell this ASIN? Does it need approval?" <br />检查这个 ASIN 我能不能卖，需不需要审批 <br />`listings_getListingsRestrictions` <EffectBadge effect="read" />
* "Make a new-product sheet from this category's template — I fill it in, you submit." <br />按这个类目的模板生成新品上架表，我填完你提交 <br />`listings_prepare_publish_queue_template` · `listings_submit_feed` <EffectBadge effect="write" />
* "This listing fails with error 8541 — which attribute is wrong?" <br />这条 Listing 报错 8541，告诉我哪个属性不合规 <br />`listings_getListingsItem` <EffectBadge effect="read" />

## FBA & inventory [#fba--inventory]

* "List every SKU with less than 30 days of sellable stock." <br />列出所有可售库存低于 30 天的 SKU <br />`query_report_data` <EffectBadge effect="read" />
* "Build an FBA shipment from the box sizes in my sheet: packing, placement, confirm, then download the box labels." <br />用表格里的箱规建一个 FBA 货件：生成装箱方案、选仓、确认、下载箱标 <br />`fbaInbound_orchestrate_packing` · `fbaInbound_listPlacementOptions` · `fbaInbound_confirm_plan_options` · `fbaInbound_get_labels` <EffectBadge effect="write" />
* "Where is shipment FBA15XXXXXXX — received and shelved yet?" <br />查一下货件 FBA15XXXXXXX 的签收和上架进度 <br />`fbaInbound_sync_shipment_status` <EffectBadge effect="read" />
* "Ship one order to a non-Amazon customer from my FBA stock — estimate the cost first." <br />用 FBA 库存给非亚马逊客户发一单多渠道配送，先预估运费 <br />`fbaOutbound_getFulfillmentPreview` · `fbaOutbound_createFulfillmentOrder` <EffectBadge effect="write" />

## Ads · SP / SB / SD [#ads--sp--sb--sd]

* "List SP campaigns with ACoS above 40%, with their keywords and bids." <br />列出 ACoS 高于 40% 的 SP 广告活动，把关键词和竞价拉出来 <br />`query_report_data` <EffectBadge effect="read" />
* "Raise these keyword bids 10% toward the suggested bid — write them to the sheet first, I'll confirm before you submit." <br />把表格里这批关键词竞价按建议价上调 10%，先写到表格我确认再提交 <br />`ads_query_target` · `ads_update_target_bid` <EffectBadge effect="write" />
* "From the last 30 days of search terms, find the converting ones I'm not targeting yet." <br />拉最近 30 天的搜索词报告，找出转化好但还没投的词 <br />`query_report_data` <EffectBadge effect="read" />
* "Add a batch of negative keywords to this ad group." <br />给这个广告组补一批否定关键词 <br />`ads_create_target` <EffectBadge effect="write" />
* "Which campaigns ran out of budget this week?" <br />这周广告预算用完的活动有哪些？ <br />`ads_campaigns_budget_usage` <EffectBadge effect="read" />

## Pricing & fees [#pricing--fees]

* "What are the Buy Box and lowest prices for these 20 ASINs right now?" <br />这 20 个 ASIN 现在的 Buy Box 价格和最低价是多少？ <br />`productPricing_getCompetitiveSummary` <EffectBadge effect="read" />
* "If I price this SKU at 29.99, what are the referral and FBA fees, and my net margin?" <br />如果把这个 SKU 定价 29.99，亚马逊佣金和 FBA 费各多少，净利率多少？ <br />`productFees_getMyFeesEstimateForSKU` <EffectBadge effect="read" />
* "Roughly what price would win the Featured Offer?" <br />拿到 Featured Offer 大概要定到什么价？ <br />`productPricing_getFeaturedOfferExpectedPriceBatch` <EffectBadge effect="read" />

## Reports & synced data [#reports--synced-data]

* "From the synced inventory reports, find stock that hasn't sold in over 90 days." <br />查已同步的库存健康报表，找出滞销超过 90 天的库存 <br />`query_report_data` <EffectBadge effect="read" />
* "Pull the Brand Analytics search query performance report — what's my click share on these terms?" <br />拉品牌分析的搜索查询表现报告，看我的 ASIN 在这些词上的点击份额 <br />`reports_createReport` · `reports_getReport` <EffectBadge effect="read" />
* "Request a Sales & Traffic report, wait until it's ready, then write it into my sheet." <br />帮我申请一份 Sales & Traffic 报告并等它生成后写入表格 <br />`reports_createReport` · `reports_getReport` <EffectBadge effect="read" />
* "Total sales and sessions by week for the last 3 months, as a trend table." <br />按周汇总最近 3 个月的销量和会话数，做一张趋势表 <br />`query_report_data` <EffectBadge effect="read" />

## Reviews & buyers [#reviews--buyers]

* "What are the 10 things buyers praise and complain about most on this ASIN?" <br />这个 ASIN 买家最常夸的和最常抱怨的 10 个点是什么？ <br />`customerFeedback_getItemReviewTopics` <EffectBadge effect="read" />
* "How have return reasons in this category trended over 6 months?" <br />这个类目最近 6 个月的退货原因趋势 <br />`customerFeedback_getBrowseNodeReturnTrends` <EffectBadge effect="read" />
* "Write a buyer-insights report for B0XXXXXXXX to guide my copy and images." <br />给 B0XXXXXXXX 生成一份买家洞察报告，指导我改文案和图片 <br />`customerFeedback_insights_report` <EffectBadge effect="credits" />

## Images & A+ [#images--a]

* "Make a white-background main image of my product in the style of this competitor shot." <br />参考这张竞品图的风格，给我的产品生成一张白底主图 <br />`generate_image` <EffectBadge effect="credits" />
* "Swap my product into this picture and keep the scene." <br />把这张图里的产品换成我的，场景保留 <br />`edit_image` <EffectBadge effect="credits" />
* "Recolor this variation family into 5 secondary images." <br />给这个变体系列改色出 5 张副图 <br />`edit_image` <EffectBadge effect="credits" />
* "Create the A+ page from the content in my sheet and submit it." <br />按表格里的内容创建 A+ 页面并提交发布 <br />`aplusContent_create_and_publish` <EffectBadge effect="write" />

## Working in Google Sheets [#working-in-google-sheets]

* "Write the results into my sheet, with headers, formats and a filter." <br />把结果写进我的表格，加上表头、格式和筛选 <br />`write_sheet` · `format_sheet_range` · `set_sheet_basic_filter` <EffectBadge effect="read" />
* "Submit the rows I changed to Amazon." <br />把我改过的行提交到亚马逊 <br />`read_sheet` · `listings_submit_feed` <EffectBadge effect="write" />

## Want one of these inside your own tools? [#want-one-of-these-inside-your-own-tools]

Ask your agent to build it on the [Tool API](/docs/mcp-api/code) — a dashboard, a listing tool, an approval page whose buttons act on Amazon. It calls the same tools with the same arguments, so it behaves exactly as it does in chat. Every job, step by step: [Workflows](/docs/mcp-api/workflows).