{
  "schemaVersion": "1.0",
  "item": {
    "slug": "salesforce-api-integration",
    "name": "Salesforce API Integration",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/salesforce-api-integration",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/salesforce-api-integration",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/salesforce-api-integration",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=salesforce-api-integration",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "bulk.md",
      "composite.md",
      "errors.md",
      "memory-template.md",
      "metadata.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/salesforce-api-integration"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/salesforce-api-integration",
    "agentPageUrl": "https://openagent3.xyz/skills/salesforce-api-integration/agent",
    "manifestUrl": "https://openagent3.xyz/skills/salesforce-api-integration/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/salesforce-api-integration/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Salesforce API Integration",
        "body": "Complete Salesforce REST API reference. See auxiliary files for detailed operations."
      },
      {
        "title": "Quick Start",
        "body": "curl \"$SF_INSTANCE_URL/services/data/v59.0/sobjects/\" \\\n  -H \"Authorization: Bearer $SF_ACCESS_TOKEN\""
      },
      {
        "title": "Setup",
        "body": "On first use, read setup.md. Preferences stored in ~/salesforce-api-integration/memory.md."
      },
      {
        "title": "When to Use",
        "body": "Any Salesforce operation: SOQL queries, record CRUD, bulk imports/exports, metadata, composite requests."
      },
      {
        "title": "Architecture",
        "body": "~/salesforce-api-integration/\n├── memory.md      # Org context and object schemas\n└── queries.md     # Saved SOQL queries"
      },
      {
        "title": "Quick Reference",
        "body": "TopicFileSetup and authenticationsetup.md, memory-template.mdSOQL queries and searchsoql.mdRecords: create, read, update, deleterecords.mdStandard objects referenceobjects.mdBulk API 2.0 for large datasetsbulk.mdComposite and batch requestscomposite.mdMetadata and schemametadata.mdError handlingerrors.md"
      },
      {
        "title": "Core Rules",
        "body": "Bearer token auth - Authorization: Bearer $SF_ACCESS_TOKEN\nInstance URL required - Each org has unique URL like https://yourorg.my.salesforce.com\nAPI version in path - Use /services/data/v59.0/ (or newer)\nSOQL for queries - Salesforce Object Query Language for data retrieval\nObject API names - Use API names: Account, Contact__c (custom objects end in __c)\nPagination for large results - Use nextRecordsUrl for results over 2000\nRate limits - Vary by edition, typically 100k+ calls/day"
      },
      {
        "title": "Authentication",
        "body": "Required environment variables:\n\nSF_ACCESS_TOKEN - OAuth access token for API calls\nSF_INSTANCE_URL - Your Salesforce instance (e.g., https://yourorg.my.salesforce.com)\n\n# All requests require these headers\ncurl \"$SF_INSTANCE_URL/services/data/v59.0/...\" \\\n  -H \"Authorization: Bearer $SF_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\""
      },
      {
        "title": "Common Traps",
        "body": "Wrong instance URL - 404 or DNS errors\nExpired access token - 401 INVALID_SESSION_ID\nMissing field permissions - Field appears null\nSOQL syntax errors - MALFORMED_QUERY\nRelationship name vs field name - Use Account.Name not AccountId.Name"
      },
      {
        "title": "External Endpoints",
        "body": "EndpointPurposehttps://*.my.salesforce.com/services/data/*REST APIhttps://*.my.salesforce.com/services/async/*Bulk APIhttps://login.salesforce.com/services/oauth2/*OAuth (production)https://test.salesforce.com/services/oauth2/*OAuth (sandbox)"
      },
      {
        "title": "Security & Privacy",
        "body": "Environment variables used:\n\nSF_ACCESS_TOKEN - for API authentication\nSF_INSTANCE_URL - for API endpoint routing\n\nSent to Salesforce: Queries, record data via your instance URL\nStays local: Access token (in environment variable only), ~/salesforce-api-integration/ preferences\nNever: Store tokens in files, log sensitive data, bypass field-level security"
      },
      {
        "title": "Scope",
        "body": "This skill ONLY:\n\nMakes requests to Salesforce REST API endpoints\nStores preferences in ~/salesforce-api-integration/\nProvides curl and code examples\n\nThis skill NEVER:\n\nAccesses files outside ~/salesforce-api-integration/\nMakes requests to non-Salesforce endpoints\nStores access tokens in files"
      },
      {
        "title": "Trust",
        "body": "By using this skill, data is sent to Salesforce (salesforce.com).\nOnly install if you trust Salesforce with your CRM data."
      },
      {
        "title": "Related Skills",
        "body": "Install with clawhub install <slug> if user confirms:\n\napi — REST API patterns\ncrm — CRM workflows\naccounting — Financial operations"
      },
      {
        "title": "Feedback",
        "body": "If useful: clawhub star salesforce-api-integration\nStay updated: clawhub sync"
      }
    ],
    "body": "Salesforce API Integration\n\nComplete Salesforce REST API reference. See auxiliary files for detailed operations.\n\nQuick Start\ncurl \"$SF_INSTANCE_URL/services/data/v59.0/sobjects/\" \\\n  -H \"Authorization: Bearer $SF_ACCESS_TOKEN\"\n\nSetup\n\nOn first use, read setup.md. Preferences stored in ~/salesforce-api-integration/memory.md.\n\nWhen to Use\n\nAny Salesforce operation: SOQL queries, record CRUD, bulk imports/exports, metadata, composite requests.\n\nArchitecture\n~/salesforce-api-integration/\n├── memory.md      # Org context and object schemas\n└── queries.md     # Saved SOQL queries\n\nQuick Reference\nTopic\tFile\nSetup and authentication\tsetup.md, memory-template.md\nSOQL queries and search\tsoql.md\nRecords: create, read, update, delete\trecords.md\nStandard objects reference\tobjects.md\nBulk API 2.0 for large datasets\tbulk.md\nComposite and batch requests\tcomposite.md\nMetadata and schema\tmetadata.md\nError handling\terrors.md\nCore Rules\nBearer token auth - Authorization: Bearer $SF_ACCESS_TOKEN\nInstance URL required - Each org has unique URL like https://yourorg.my.salesforce.com\nAPI version in path - Use /services/data/v59.0/ (or newer)\nSOQL for queries - Salesforce Object Query Language for data retrieval\nObject API names - Use API names: Account, Contact__c (custom objects end in __c)\nPagination for large results - Use nextRecordsUrl for results over 2000\nRate limits - Vary by edition, typically 100k+ calls/day\nAuthentication\n\nRequired environment variables:\n\nSF_ACCESS_TOKEN - OAuth access token for API calls\nSF_INSTANCE_URL - Your Salesforce instance (e.g., https://yourorg.my.salesforce.com)\n# All requests require these headers\ncurl \"$SF_INSTANCE_URL/services/data/v59.0/...\" \\\n  -H \"Authorization: Bearer $SF_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\"\n\nCommon Traps\nWrong instance URL - 404 or DNS errors\nExpired access token - 401 INVALID_SESSION_ID\nMissing field permissions - Field appears null\nSOQL syntax errors - MALFORMED_QUERY\nRelationship name vs field name - Use Account.Name not AccountId.Name\nExternal Endpoints\nEndpoint\tPurpose\nhttps://*.my.salesforce.com/services/data/*\tREST API\nhttps://*.my.salesforce.com/services/async/*\tBulk API\nhttps://login.salesforce.com/services/oauth2/*\tOAuth (production)\nhttps://test.salesforce.com/services/oauth2/*\tOAuth (sandbox)\nSecurity & Privacy\n\nEnvironment variables used:\n\nSF_ACCESS_TOKEN - for API authentication\nSF_INSTANCE_URL - for API endpoint routing\n\nSent to Salesforce: Queries, record data via your instance URL Stays local: Access token (in environment variable only), ~/salesforce-api-integration/ preferences Never: Store tokens in files, log sensitive data, bypass field-level security\n\nScope\n\nThis skill ONLY:\n\nMakes requests to Salesforce REST API endpoints\nStores preferences in ~/salesforce-api-integration/\nProvides curl and code examples\n\nThis skill NEVER:\n\nAccesses files outside ~/salesforce-api-integration/\nMakes requests to non-Salesforce endpoints\nStores access tokens in files\nTrust\n\nBy using this skill, data is sent to Salesforce (salesforce.com). Only install if you trust Salesforce with your CRM data.\n\nRelated Skills\n\nInstall with clawhub install <slug> if user confirms:\n\napi — REST API patterns\ncrm — CRM workflows\naccounting — Financial operations\nFeedback\nIf useful: clawhub star salesforce-api-integration\nStay updated: clawhub sync"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/salesforce-api-integration",
    "publisherUrl": "https://clawhub.ai/ivangdavila/salesforce-api-integration",
    "owner": "ivangdavila",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/salesforce-api-integration",
    "downloadUrl": "https://openagent3.xyz/downloads/salesforce-api-integration",
    "agentUrl": "https://openagent3.xyz/skills/salesforce-api-integration/agent",
    "manifestUrl": "https://openagent3.xyz/skills/salesforce-api-integration/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/salesforce-api-integration/agent.md"
  }
}