---
name: extract_phone_numbers
kind: function
lang: py
domain: cybersecurity
version: "1.0.0"
purity: pure
signature: "def extract_phone_numbers(text: str) -> list[dict]"
description: "Extrae numeros de telefono en formato E.164 (`+CC...`) y formato local ES (9 digitos empezando por 6/7/8/9), con offsets. Permite separadores `space` y `-` entre grupos."
tags: [ioc, phone, e164, spain, regex, extract, cybersecurity, python]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: ""
imports: [re]
params:
  - name: text
    desc: "string de texto del que extraer telefonos"
output: "lista de dicts con {value, start, end, type='phone_number'}"
tested: true
tests:
  - "Numero E.164 con espacios"
  - "Numero local ES de 9 digitos"
  - "Numero demasiado corto se descarta"
test_file_path: "python/functions/cybersecurity/tests/test_extract_iocs.py"
file_path: "python/functions/cybersecurity/extract_phone_numbers.py"
---

## Ejemplo

```python
extract_phone_numbers("Llamar al +34 612 345 678 o al 912345678")
# [{"value": "+34 612 345 678", "start": 10, "end": 25, "type": "phone_number"},
#  {"value": "912345678", "start": 31, "end": 40, "type": "phone_number"}]
```

## Notas

E.164 (ITU-T): entre 8 y 15 digitos tras el `+`. ES local: 9 digitos exactos, primero ∈ {6,7,8,9}. No se discrimina entre movil y fijo. No se normaliza el formato — el caller decide. Para parseo robusto multi-pais usar `phonenumbers` (libpostal-style), pero esa dependencia no es necesaria para extraer candidatos como IoC.
