crowdsecurity · LaurenceJJones · Jul 9, 2025 · Jul 7, 2025 · Jul 9, 2025 · Jul 9, 2025
diff --git a/crowdsec-docs/docs/getting_started/getting_started.md b/crowdsec-docs/docs/getting_started/getting_started.md
diff --git a/crowdsec-docs/docs/getting_started/install.mdx b/crowdsec-docs/docs/getting_started/install.mdx
diff --git a/crowdsec-docs/docs/getting_started/install_freebsd.md b/crowdsec-docs/docs/getting_started/install_freebsd.md
diff --git a/crowdsec-docs/docs/getting_started/install_softagent.md b/crowdsec-docs/docs/getting_started/install_softagent.md
@@ -4,7 +4,7 @@ title: Soft Agent
 sidebar_position: 1
 ---
 
-# Using our SDK
+# Using our PHP SDK
 
 With the help of our SDK, If you are developing security software that detects misbehaviors and does remediation on IPs, you can send signals about your detections and benefit from the community blocklist.
 

diff --git a/crowdsec-docs/docs/getting_started/intro.mdx b/crowdsec-docs/docs/getting_started/intro.mdx
diff --git a/crowdsec-docs/docs/getting_started/sdk_intro.mdx b/crowdsec-docs/docs/getting_started/sdk_intro.mdx
@@ -0,0 +1,21 @@
+---
+id: sdk_intro
+title: introduction to the SDKs
+sidebar_position: 1
+---
+
+CrowdSec offers lightweight SDKs for Python and PHP to help developers seamlessly integrate signal sharing capabilities into their security tools, platforms, or services.
+
+By using these SDKs, you can report signals such as suspicious IP activity or confirmed attacks directly to the Central API (CAPI). In return, your users gain access to the CrowdSec Community Blocklist, a curated and constantly updated list of IPs involved in malicious behavior observed across the global CrowdSec network.
+
+Why Integrate the SDK:
+- **Simple Integration** — Add signal sharing with just a few lines of code
+- **Community-Powered Protection** — Contributions help power our global threat intelligence network
+- **Mutual Benefit** — Your platform shares valuable intelligence and gains stronger real-time protection in return
+
+## Supported SDKs
+
+* [Python SDK](install_pyagent)
+* [PHP SDK](install_softagent)
+
+Whether you're building a WAF, SIEM, or a custom security tool, the CrowdSec SDKs make it easy to contribute to and benefit from a collaborative defense network.