A connector is the authorization channel between StoreClaw and an external platform. After a platform is connected, StoreClaw can access the relevant functions of that platform within the authorized scope to read or act on the corresponding data. You can revoke authorization at any time.

StoreClaw provides built-in connectors for Shopify, Amazon, and social platforms. After a platform is connected, StoreClaw can read orders, inventory, engagement data, and other business information as needed, so its analysis is based on the data you have authorized.

What Connectors Are For

Connectors primarily provide business context to StoreClaw:

  • Platform access: Supports ecommerce, social media, and marketing channels.
  • Data retrieval: Reads business metrics such as inventory, conversion rate, and engagement rate within the authorized scope.
  • Authorization setup: Uses API credentials or OAuth authorization. Access can be revoked at any time.

Connect a Platform

  1. Open the connection center: Click Connectors in the left navigation.

  2. Filter by category: Switch the tabs at the top to find the relevant category:

    • Ecommerce: Shopify, Amazon, Genstore, Wix, WooCommerce, eBay, and others.
    • Social Media: Instagram, YouTube, Facebook, TikTok, LinkedIn, Reddit, Twitter/X, and others.
    • Marketing: Gmail and additional platforms that will be added over time.

  3. Authorize the connection (Shopify example):

    • Click the Shopify card to open the connection window.
    • Enter the Shop Domain, Client ID, and Client Secret. To learn how to get the Shopify Client ID and Client Secret, see Connect Your First Store.
    • Click Connect Shopify to finish the setup.
  4. Verify the status: After the connection succeeds, the card shows Connected in the upper-right corner.

What You Can Do After Connecting

After a connection is established, different platforms make additional data and actions available to StoreClaw. These capabilities are used only when you trigger them in chat or include them in a scheduled task. Connecting a platform does not start these workflows automatically by itself.

  • Ecommerce channels (Shopify, Amazon, Genstore, SellerSprite, and others):

    • Order analysis: When you ask for order-related analysis, StoreClaw can read order data and generate sales reports within the authorized scope.
    • Inventory review: When you ask StoreClaw to check inventory, or when a scheduled task runs, it can review stock levels and flag items that may need restocking.
    • Customer analysis: When requested, StoreClaw can summarize customer profiles, purchase history, and related information to support marketing decisions.

    • Example prompts:

      • "Analyze my Shopify sales data from last week and identify best sellers and potential issues."
      • "Forecast which products in my inventory will need restocking over the next two weeks."

  • Social media channels (TikTok, Instagram, Facebook, and others):

    • Content distribution: When you explicitly ask StoreClaw to publish, it can post approved content to authorized social accounts.
    • Engagement analysis: When requested, or through a scheduled task, StoreClaw can review post performance, comment sentiment, and engagement metrics.

    • Example prompts:

      • "Analyze my recent Instagram posts and tell me which ones had the highest engagement rate."
      • "Draft a product promotion post suitable for TikTok."

  • Marketing channels (Gmail):

    • Content drafting and send planning: When requested, StoreClaw can help draft customer emails and organize outreach ideas based on your workflow.

    • Example prompts:

      • "Write a reorder email for past customers with a strong subject line."
      • "Analyze customer inquiry emails in my Gmail inbox and summarize the most common questions."

Manage Connected Connectors

  • Disconnect: For connected ecommerce or social channels, you can disconnect at any time. Click the connected platform card and select Disconnect in the dialog.

    Tip: Disconnecting does not delete any data on the original platform and does not affect platform operations. It only prevents StoreClaw from accessing that platform's data. Related skill capabilities remain unavailable until the platform is connected again.

  • Reauthorize: If a connection becomes invalid, such as when authorization expires, related actions in StoreClaw may fail. In that case, repeat the connection flow to authorize again.

FAQ

Q: Do I have to connect a platform before I can use StoreClaw?

A: No. Connectors add business context, but they are not required for basic use. Even without any connected platform, you can still use StoreClaw for conversations such as drafting copy or discussing analysis approaches. After a connection is added, StoreClaw can generate analysis and recommendations based on authorized business data.

Q: Is it safe to connect store data?

A: StoreClaw uses official OAuth flows or API keys to connect to platforms and does not store your account password. The authorization scope is limited to the minimum permissions required by the feature, and all API keys are stored in encrypted form. You can revoke access at any time either in StoreClaw or directly in the third-party platform's admin settings.

Q: Why do some connectors require a Secret while others just redirect to sign in?

A: This depends on the security model of the platform. Ecommerce platforms such as Shopify usually require API credentials to support stable data synchronization, while social platforms more commonly use OAuth redirect authorization.

Q: Will StoreClaw automatically operate my account after a connection is established?

A: No, unless you explicitly configure automation in Scheduled Tasks. Publishing or modification requests are not carried out automatically without your confirmation.

Q: Shopify is connected, but StoreClaw says it cannot get permissions in chat. What should I check?

A: Confirm the following:

  • You selected the correct store during authorization.
  • The platform account contains relevant data. For example, a newly created store may not have historical orders yet.
  • The required authorization scope is complete. Some platforms let you choose scopes manually during authorization, so make sure StoreClaw's required scopes are included.

Q: Can I connect multiple accounts for the same platform?

A: The current version supports one account per connector.

Q: If I disconnect a platform, will previously generated reports still be available?

A: Yes. Analysis reports and conversation history already stored in StoreClaw are not affected. Disconnecting only stops future data retrieval and does not delete existing content.

Q: Why can't StoreClaw see buyer email addresses on Amazon?

A: This is due to Amazon's privacy policy. No third-party tool, including StoreClaw, can access buyer email addresses. If you need to contact a buyer, use Amazon's internal messaging system.

Q: Does connector authorization expire?

A: Some platform authorizations may eventually require reauthorization, for example if the platform revokes the token, changes its permissions, or the user disconnects access on the platform side. When supported, StoreClaw refreshes authorization automatically, but if a connector becomes invalid you can simply reconnect it.

Q: Where can I revoke StoreClaw's access to a third-party platform?

A: In addition to disconnecting it in StoreClaw, you can revoke access directly in the corresponding platform settings, such as Shopify's Apps page or the Google account page for Third-party app access. Both methods have the same effect. It is best to use one method consistently to avoid state mismatches.

连接器 (Connector) 是 StoreClaw 与外部平台之间的授权通道。连接平台后，StoreClaw 可在授权范围内访问该平台的相关功能，用于读取或操作对应数据。您可以随时撤销授权。

您可通过 StoreClaw 内置的连接器连接 Shopify、Amazon 及社交媒体平台。连接后，StoreClaw 可按任务需要读取订单、库存、互动等数据，使分析结果基于已授权的业务信息。

连接器的作用

连接器主要用于补充 StoreClaw 的业务上下文：

  • 平台接入： 支持连接电商、社交媒体与营销渠道。
  • 数据读取： 在授权范围内读取库存、转化率、互动率等业务指标。
  • 授权配置： 通过 API 凭证或 OAuth 授权完成接入，授权可随时撤销。

如何连接平台

  1. 进入连接中心： 点击左侧导航栏的 连接器。

  2. 筛选分类： 在顶部切换标签，定位所属分类：

    • 电商： Shopify, Amazon, Genstore, SellerSprite 等。
    • 社交媒体： Instagram, YouTube, Facebook, TikTok, LinkedIn, Reddit, Twitter/X 等。
    • 营销： Gmail。

  3. 完成授权（以 Shopify 为例）：

    • 点击 Shopify 卡片弹出连接窗口。
    • 输入 Shop Domain（店铺域名）、Client ID 和 Client Secret。有关如何获取 Shopify Client ID 和 Client Secret，可阅读连接您的第一家店铺。
    • 点击 连接 Shopify 按钮完成对接。
  4. 验证状态： 连接成功后，卡片右上角将显示已连接。

连接后能做什么

连接成功后，不同平台会为 StoreClaw 提供可调用的数据和操作能力。这些能力仅会在您在会话中主动触发，或将其配置到定时任务后按计划执行；仅连接平台本身并不会自动启动这些流程。

  • 电商渠道（Shopify, Amazon, Genstore, SellerSprite 等）：

    • 订单分析： 当您发起订单相关分析时，StoreClaw 可在授权范围内读取订单数据并生成销售分析报表。
    • 库存检查： 当您要求 StoreClaw 检查库存，或相关定时任务运行时，它可查看库存情况并提示可能需要补货的商品。
    • 客户分析： 在您发起请求时，StoreClaw 可汇总客户画像、购买记录等信息，辅助营销策略制定。

    • 示例指令：

      • "帮我分析上周 Shopify 店铺的销售数据，找出热销产品和潜在问题"
      • "预测一下我库存中哪些产品需要在未来两周内补货"

  • 社交媒体 (TikTok/Instagram/Facebook 等)：

    • 内容发布： 当您明确要求发布时，StoreClaw 可将已确认的内容发布到已授权的社交账号。
    • 互动分析： 在您发起请求，或相关定时任务运行时，StoreClaw 可查看帖子热度、评论情绪与互动指标。

    • 示例指令：

      • "分析我 Instagram 最近发布的帖子，哪些内容互动率最高"
      • "帮我写一条适合 TikTok 的产品推广文案"

  • 营销渠道 (Gmail)：

    • StoreClaw 内容撰写与发送规划：

    • 示例指令：

      • "帮我写一封给老客户的复购邮件，主题要吸引人"
      • "分析我 Gmail 收件箱中的客户咨询邮件，总结常见问题"

管理已连接的连接器

  • 断开连接：对于已连接的电商或社媒渠道，您可随时断开连接。点击已连接的平台卡片，在弹窗内找到 断开连接 按钮即可断开连接。

    提示： 断开连接不会删除您在该平台的数据，也不会影响平台本身的运营。断开后 StoreClaw 将无法再访问该平台数据，相关技能功能会暂时不可用，重新连接后即可恢复。

  • 重新授权：如果连接出现异常（如授权过期），在 StoreClaw 中执行的相关操作可能会失败。此时按照连接流程重新操作一次即可完成重新授权。

常见问题 (FAQ)

Q：我必须先连接才能使用 StoreClaw 吗？

A： 不必。连接器用于补充业务上下文。即使未连接任何平台，您仍可使用 StoreClaw 的对话能力（如文案撰写、数据分析建议等）。连接后，StoreClaw 可基于已授权的业务数据生成分析和建议。

Q：连接店铺数据安全吗？

A： StoreClaw 通过官方 OAuth 授权流程或 API Key 连接各平台，不会储存您的账号密码。授权范围严格限于功能所需的最小权限，所有 API 密钥均加密存储。您可以随时在 StoreClaw 管理页面撤销授权，也可以直接在对应第三方平台的管理后台撤销。

Q：为什么有的连接器需要输入 Secret，有的只需要跳转登录？

A： 这取决于不同平台的安全协议。电商平台（如 Shopify）通常需要 API 凭证以确保数据同步的稳定性；而社交平台多采用 OAuth 跳转授权。

Q：连接后 StoreClaw 会自动操作我的账号吗？

A： 除非您在 定时任务 中设置了自动化指令，否则 StoreClaw 不会擅自操作。所有的发布或修改建议都会先提交给您确认。

Q：Shopify 连接成功后，StoreClaw 对话时显示「无法获得权限」？

A： 请确认以下几点：

  • 授权时选择的是正确的店铺；
  • 该平台账号有对应数据（如新建店铺可能没有历史订单）；
  • 授权范围是否完整（部分平台授权时可手动勾选权限范围，请确保已勾选 StoreClaw 所需权限）。

Q：我能同时连接同一平台的多个账号吗？

A： 当前版本每个连接器仅支持连接一个账号。

Q：断开连接后，之前生成的报告数据还在吗？

A： 在 StoreClaw 中保存的分析报告、对话记录不受影响。断开连接只是停止后续数据拉取，不会删除已有内容。

Q：Amazon 为什么看不到买家邮箱？

A： 这是亚马逊平台的隐私政策限制，所有第三方工具（包括 StoreClaw）均无法获取买家邮箱。如需联系买家，只能通过亚马逊站内信系统进行。

Q：连接器授权会过期吗？

A： 不会过期，StoreClaw 会通过技术方案自动更新授权。

Q：在哪里可以撤销 StoreClaw 对第三方平台的授权？

A： 除了在 StoreClaw 内断开连接外，您也可以直接在对应平台的账户设置中撤销。例如 Shopify 的「Apps」、Google 账户的「第三方应用权限」页面。两边操作效果相同，建议选择一处操作即可，避免状态不一致。