Tools

.gitignore

@@ -1,2 +1,4 @@
 *.mp3
 *.xlsx
+video_analysis_output/
+get-pip.py

Analisador de Vídeo do YouTube com GPT-4o.md

@@ -0,0 +1,125 @@
+# Analisador de Vídeo do YouTube com GPT-4o
+
+Este script Python automatiza o processo de baixar um vídeo do YouTube, extrair frames em intervalos regulares, e usar a API do OpenAI (GPT-4o) para analisar cada frame (neste caso, contar aves). Os resultados são salvos em um arquivo JSON.
+
+## Funcionalidades
+
+- Baixa vídeos do YouTube usando `yt-dlp`.
+- Extrai frames do vídeo a cada X segundos usando `opencv-python`.
+- Codifica os frames extraídos para o formato base64.
+- Envia cada frame para a API do OpenAI (GPT-4o) com um prompt customizável para análise.
+- Salva os resultados da análise (incluindo contagem de aves e a resposta bruta da API) em um arquivo JSON estruturado.
+
+## Pré-requisitos
+
+- Python 3.7+
+- `pip` (gerenciador de pacotes Python)
+- `yt-dlp` instalado e acessível no PATH do sistema. (Se não estiver instalado via pip, pode ser necessário instalar separadamente: [https://github.com/yt-dlp/yt-dlp](https://github.com/yt-dlp/yt-dlp))
+
+## Instalação
+
+1.  **Clone ou baixe este repositório/script:**
+    Salve o arquivo `video_analyzer.py` e `requirements.txt` no seu computador.
+
+2.  **Crie um ambiente virtual (recomendado):**
+    ```bash
+    python -m venv venv
+    source venv/bin/activate  # No Windows use `venv\Scripts\activate`
+    ```
+
+3.  **Instale as dependências:**
+    ```bash
+    pip install -r requirements.txt
+    ```
+    Isso instalará `yt-dlp`, `opencv-python`, e `openai`.
+
+## Configuração
+
+Antes de executar o script, você **precisa** editar o arquivo `video_analyzer.py` e substituir os seguintes placeholders:
+
+1.  `VIDEO_URL`: Substitua `"URL_DO_SEU_VIDEO_AQUI"` pela URL completa do vídeo do YouTube que você deseja analisar.
+    ```python
+    VIDEO_URL = "https://www.youtube.com/watch?v=dQw4w9WgXcQ" # Exemplo
+    ```
+
+2.  `OPENAI_API_KEY`: Substitua `"SUA_CHAVE_API_OPENAI_AQUI"` pela sua chave secreta da API OpenAI.
+    ```python
+    OPENAI_API_KEY = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" # Exemplo
+    ```
+
+3.  **(Opcional) `PROMPT_TEXT`**: Você pode ajustar o prompt enviado ao GPT-4o para se adequar melhor à sua necessidade de análise. O padrão é:
+    ```python
+    PROMPT_TEXT = "Quantas aves existem nesta imagem? Responda apenas com o número."
+    ```
+
+4.  **(Opcional) `FRAME_INTERVAL_SECONDS`**: Altere o valor (padrão: 5) para definir o intervalo em segundos entre os frames extraídos.
+    ```python
+    FRAME_INTERVAL_SECONDS = 10 # Exemplo: extrair a cada 10 segundos
+    ```
+
+5.  **(Opcional) `OUTPUT_DIR`**: Define o diretório onde o vídeo baixado, os frames e o arquivo de resultados serão salvos (padrão: `./video_analysis_output`).
+    ```python
+    OUTPUT_DIR = "./meus_resultados_video" # Exemplo
+    ```
+
+## Como Executar
+
+1.  Certifique-se de que você configurou a `VIDEO_URL` e `OPENAI_API_KEY` no script `video_analyzer.py`.
+2.  Navegue até o diretório onde você salvou os arquivos no seu terminal.
+3.  Execute o script:
+    ```bash
+    python video_analyzer.py
+    ```
+
+O script irá:
+- Criar o diretório de saída (se não existir).
+- Baixar o vídeo especificado.
+- Extrair os frames no intervalo definido.
+- Codificar cada frame e enviá-lo para a API do OpenAI.
+- Imprimir o progresso e os resultados da análise no console.
+- Salvar os resultados detalhados no arquivo `analysis_results.json` dentro do diretório de saída.
+
+## Arquivos de Saída
+
+- **`video_analysis_output/`** (ou o diretório definido em `OUTPUT_DIR`):
+    - `downloaded_video.mp4`: O vídeo baixado do YouTube.
+    - `frame_xxxx_time_yy.zzs.png`: Os frames extraídos do vídeo.
+    - `analysis_results.json`: Um arquivo JSON contendo a lista de análises para cada frame processado, incluindo o caminho do frame, timestamp aproximado e a resposta da API.
+
+Exemplo de `analysis_results.json`:
+```json
+[
+    {
+        "frame_path": "./video_analysis_output/frame_0000_time_0.00s.png",
+        "timestamp_approx_sec": "0.00",
+        "analysis": {
+            "bird_count": 3,
+            "raw_response": "3"
+        }
+    },
+    {
+        "frame_path": "./video_analysis_output/frame_0001_time_5.00s.png",
+        "timestamp_approx_sec": "5.00",
+        "analysis": {
+            "error": "Failed to parse bird count from response.",
+            "raw_response": "Parece haver algumas aves voando ao fundo."
+        }
+    },
+    {
+        "frame_path": "./video_analysis_output/frame_0002_time_10.00s.png",
+        "timestamp_approx_sec": "10.00",
+        "analysis": {
+            "error": "API key not configured."
+        }
+    }
+    // ... mais resultados
+]
+```
+
+## Solução de Problemas
+
+- **Erro `yt-dlp: command not found`**: Certifique-se de que `yt-dlp` está instalado corretamente e acessível no PATH do seu sistema. Tente reinstalar com `pip install --force-reinstall yt-dlp`.
+- **Erro ao baixar vídeo**: Verifique a URL do vídeo e sua conexão com a internet. Alguns vídeos podem ter restrições de download.
+- **Erro da API OpenAI**: Verifique se sua chave da API está correta, se você tem créditos/limites suficientes na sua conta OpenAI e se o modelo (`gpt-4o`) está correto e disponível para sua chave.
+- **Frames não extraídos**: Verifique se o arquivo de vídeo foi baixado corretamente e se o OpenCV (`cv2`) está funcionando. O vídeo pode estar corrompido ou em um formato incompatível.
+

Script Python de Busca e Extração de Conteúdo Web.md

@@ -0,0 +1,87 @@
+# Script Python de Busca e Extração de Conteúdo Web
+
+## 1. Propósito
+
+Este script Python foi projetado para automatizar o processo de busca de informações na web usando a API Tavily, com funcionalidades especiais para priorizar e extrair conteúdo de páginas da Wikipedia, incluindo revisões históricas específicas por data. O conteúdo das páginas encontradas é baixado e convertido para o formato Markdown para fácil leitura e processamento posterior.
+
+## 2. Requisitos
+
+*   **Python:** Versão 3.11 ou superior.
+*   **Bibliotecas Python:** `requests`, `tavily-python`, `markdownify`, `wikipedia-api`.
+
+Você pode instalar as bibliotecas necessárias usando o pip para Python 3.11:
+```bash
+python3.11 -m pip install requests tavily-python markdownify wikipedia-api
+```
+
+## 3. Configuração
+
+*   **Chave da API Tavily:** O script requer uma chave da API Tavily para funcionar. Você precisa obter sua própria chave no [site da Tavily AI](https://tavily.com/).
+*   **Inserir a Chave:** Abra o arquivo `search_script_v2.py` em um editor de texto e localize a linha que define a variável `TAVILY_API_KEY` (próximo ao início do script ou dentro do bloco `if __name__ == "__main__":`). Substitua o valor atual pela sua chave da API Tavily.
+    ```python
+    # Exemplo dentro do if __name__ == "__main__":
+    TAVILY_API_KEY = "SUA_CHAVE_TAVILY_AQUI"
+    ```
+    *Nota: No script fornecido (`search_script_v2.py`), a chave que você forneceu já foi inserida para teste, mas é recomendável que você a gerencie de forma segura (ex: variáveis de ambiente) para uso futuro.*
+
+*   **Idioma da Wikipedia:** Por padrão, o script está configurado para buscar na Wikipedia em inglês (`WIKI_LANG = 'en'`). Se desejar usar outro idioma, altere o valor desta variável perto do início do script.
+    ```python
+    WIKI_LANG = 'pt' # Exemplo para Português
+    ```
+
+## 4. Uso
+
+### Execução Básica
+
+Você pode executar o script diretamente do terminal usando Python 3.11:
+```bash
+python3.11 search_script_v2.py
+```
+Por padrão, o script executará os exemplos definidos no bloco `if __name__ == "__main__":`:
+1.  Uma busca geral por "History of Artificial Intelligence".
+2.  Uma busca por "Albert Einstein" com prioridade para a Wikipedia.
+3.  Uma busca pela revisão histórica da página "Python (programming language)" da Wikipedia próxima a 15 de janeiro de 2010.
+
+### Função Principal: `search_and_extract`
+
+O núcleo do script é a função `search_and_extract`. Você pode importá-la em outros scripts Python ou modificar o bloco `if __name__ == "__main__":` para realizar buscas personalizadas.
+
+**Parâmetros:**
+
+*   `query` (str): O termo ou frase que você deseja pesquisar.
+*   `use_wikipedia_priority` (bool, opcional): Se `True`, o script tentará encontrar um resultado da Wikipedia primeiro. Se encontrar, processará apenas esse resultado. Se não encontrar, processará os 5 primeiros resultados gerais. Padrão: `False`.
+*   `wikipedia_date` (str, opcional): Se `use_wikipedia_priority` for `True` e esta data (formato "AAAA-MM-DD") for fornecida, o script buscará especificamente a revisão da página da Wikipedia (usando `query` como título da página) mais próxima e anterior ou igual a essa data. A busca geral da Tavily não será realizada neste caso. Padrão: `None`.
+
+**Exemplos de Modificação no Script:**
+
+```python
+if __name__ == "__main__":
+    TAVILY_API_KEY = "SUA_CHAVE_TAVILY_AQUI" # Não esqueça sua chave!
+
+    # Exemplo: Buscar sobre "Machine Learning" (5 primeiros resultados)
+    resultados_ml = search_and_extract("Machine Learning")
+    # ... (código para salvar ou processar resultados_ml)
+
+    # Exemplo: Buscar "Brazil" na Wikipedia (prioritário)
+    resultados_br_wiki = search_and_extract("Brazil", use_wikipedia_priority=True)
+    # ...
+
+    # Exemplo: Buscar revisão histórica de "World War II" de 1945-05-08
+    resultados_ww2_hist = search_and_extract("World War II", use_wikipedia_priority=True, wikipedia_date="1945-05-08")
+    # ...
+```
+
+## 5. Saída
+
+*   **Console:** O script imprime mensagens de progresso no console, indicando qual busca está sendo realizada, quais URLs estão sendo processadas e se houve algum erro (como falha ao acessar uma URL).
+*   **Arquivos Markdown (.md):** Para cada página web processada com sucesso, o script salva seu conteúdo convertido em um arquivo `.md` no mesmo diretório onde o script foi executado. Os nomes dos arquivos são gerados com base no tipo de busca e na ordem dos resultados (ex: `general_result_1.md`, `wiki_priority_result_1.md`, `historical_result_python_2010.md`).
+    *   Arquivos de revisões históricas da Wikipedia incluem um cabeçalho indicando o título da página, o timestamp e ID da revisão, e a data alvo da busca.
+    *   Outros arquivos incluem um cabeçalho simples indicando a URL de origem.
+
+## 6. Limitações
+
+*   **Bloqueios de Sites:** Alguns sites podem bloquear tentativas de download automático de conteúdo (scraping), resultando em erros (como o erro 403 Forbidden observado com Cloudflare durante os testes). O script tenta lidar com isso, mas não pode garantir o acesso a todos os sites.
+*   **Qualidade da Conversão para Markdown:** A conversão de HTML para Markdown depende da estrutura da página original e da biblioteca `markdownify`. Páginas complexas podem não ser convertidas perfeitamente.
+*   **Precisão do Título da Wikipedia:** Ao buscar revisões históricas, é importante fornecer o título exato da página da Wikipedia (conforme usado na URL, substituindo espaços por underscores se necessário, embora o script tente lidar com isso). O script tenta encontrar o título canônico em caso de redirecionamentos, mas pode falhar em casos complexos.
+*   **API Tavily:** A qualidade e a quantidade dos resultados dependem da API Tavily e do plano associado à sua chave.
+

requirements-search-web.txt

@@ -0,0 +1 @@
+gradio requests readability-lxml bs4

requirements-video.txt

@@ -0,0 +1 @@
+yt-dlp opencv-python openai

requirements.txt

@@ -1,2 +0,0 @@
-gradio
-requests

search_script_v2.py

@@ -0,0 +1,311 @@
+# -*- coding: utf-8 -*-
+import os
+import requests
+from tavily import TavilyClient
+import markdownify
+import wikipediaapi
+from datetime import datetime, timezone
+import urllib.parse
+from readability import Document
+from bs4 import BeautifulSoup
+import os
+
+# --- Configuração Inicial ---
+TAVILY_API_KEY = os.getenv("TAVILY_API_KEY")
+tavily = None # Será inicializado na função principal
+
+# Configuração da API da Wikipedia
+WIKI_LANG = 'en' # Linguagem da Wikipedia (atualizado para inglês)
+wiki_wiki = wikipediaapi.Wikipedia(
+    language=WIKI_LANG,
+    extract_format=wikipediaapi.ExtractFormat.HTML, # Usado apenas para page.exists()
+    user_agent='MyCoolSearchBot/1.0 ([email protected])' # Definir um User-Agent é boa prática
+)
+MEDIAWIKI_API_URL = f"https://{WIKI_LANG}.wikipedia.org/w/api.php"
+HEADERS = {
+    'User-Agent': 'MyCoolSearchBot/1.0 ([email protected])'
+}
+
+# --- Funções Auxiliares ---
+
+def is_wikipedia_url(url):
+    """Verifica se uma URL pertence ao domínio da Wikipedia."""
+    return "wikipedia.org" in url.lower()
+
+def download_and_convert_to_md(url):
+    """Baixa o conteúdo HTML de uma URL e converte para Markdown."""
+    print(f"Baixando e convertendo: {url}")
+    try:
+        response = requests.get(url, headers=HEADERS, timeout=20)
+        response.raise_for_status()  # Verifica se houve erro no request
+        # Tenta detectar a codificação, mas assume UTF-8 como fallback
+        response.encoding = response.apparent_encoding or 'utf-8'
+        html_content = response.text
+        
+         # Usa readability para extrair o conteúdo principal
+        doc = Document(html_content)
+        title = doc.short_title()
+        cleaned_html = doc.summary()
+    
+         # Remove scripts e estilos restantes com BeautifulSoup (filtro extra)
+        soup = BeautifulSoup(cleaned_html, "html.parser")
+        for tag in soup(["script", "style", "noscript"]):
+            tag.decompose()
+
+        cleaned_html = str(soup)        
+        
+        # Usa markdownify para converter HTML para Markdown
+        md_content = markdownify.markdownify(
+            cleaned_html, 
+            heading_style="ATX", 
+            strip=['script', 'style'], 
+            escape_underscores=False)
+        
+        #return md_content
+        return f"# {title}\n\n" + md_content.strip()
+    except requests.exceptions.RequestException as e:
+        print(f"Erro ao acessar a URL {url}: {e}")
+        return None
+    except Exception as e:
+        print(f"Erro ao converter HTML para Markdown da URL {url}: {e}")
+        return None
+
+# --- Funções Específicas da Wikipedia ---
+
+def get_wikipedia_revision_info(page_title, target_date_str):
+    """Busca o ID e timestamp da revisão mais próxima (<=) da data fornecida via API MediaWiki."""
+    try:
+        # Converte a data string para um objeto datetime e formata para ISO 8601 com Z (UTC)
+        target_dt = datetime.strptime(target_date_str, '%Y-%m-%d')
+        # Precisamos do final do dia para garantir que incluímos todas as revisões daquele dia
+        target_dt_end_of_day = target_dt.replace(hour=23, minute=59, second=59, tzinfo=timezone.utc)
+        target_timestamp_iso = target_dt_end_of_day.strftime('%Y-%m-%dT%H:%M:%SZ')
+    except ValueError:
+        print("Formato de data inválido. Use AAAA-MM-DD.")
+        return None, None
+
+    params = {
+        "action": "query",
+        "prop": "revisions",
+        "titles": page_title,
+        "rvlimit": 1,
+        "rvdir": "older", # Busca a revisão imediatamente anterior ou igual ao timestamp
+        "rvprop": "ids|timestamp", # Queremos o ID da revisão e o timestamp
+        "rvstart": target_timestamp_iso, # Começa a busca a partir desta data/hora
+        "format": "json",
+        "formatversion": 2 # Formato JSON mais moderno e fácil de parsear
+    }
+
+    try:
+        print(f"Consultando API MediaWiki para revisão de '{page_title}' em {target_date_str}...")
+        response = requests.get(MEDIAWIKI_API_URL, params=params, headers=HEADERS, timeout=15)
+        response.raise_for_status()
+        data = response.json()
+
+        # Verifica se a página foi encontrada
+        page_data = data.get("query", {}).get("pages", [])
+        if not page_data or page_data[0].get("missing", False):
+            print(f"Página '{page_title}' não encontrada na API MediaWiki.")
+            # Tenta verificar com a biblioteca wikipediaapi como fallback (pode pegar redirecionamentos)
+            page = wiki_wiki.page(page_title)
+            if page.exists():
+                 print(f"Página '{page_title}' existe (possivelmente redirecionada para '{page.title}'). Tentando novamente com o título canônico...")
+                 return get_wikipedia_revision_info(page.title, target_date_str) # Chama recursivamente com o título correto
+            else:
+                 print(f"Página '{page_title}' realmente não encontrada.")
+                 return None, None
+
+        # Extrai as revisões
+        revisions = page_data[0].get("revisions", [])
+        if not revisions:
+            print(f"Nenhuma revisão encontrada para '{page_title}' antes ou em {target_date_str}.")
+            # Pode acontecer se a página foi criada depois da data alvo
+            return None, None
+
+        revision = revisions[0]
+        revid = revision.get("revid")
+        timestamp = revision.get("timestamp")
+        print(f"Encontrada revisão: ID={revid}, Timestamp={timestamp}")
+        return revid, timestamp
+
+    except requests.exceptions.RequestException as e:
+        print(f"Erro ao chamar a API MediaWiki: {e}")
+        return None, None
+    except Exception as e:
+        print(f"Erro ao processar resposta da API MediaWiki: {e}")
+        return None, None
+
+def get_wikipedia_page_historical_content(page_title, target_date_str):
+    """Obtém o conteúdo Markdown de uma revisão histórica específica da Wikipedia."""
+    # Busca o ID da revisão correta usando a API MediaWiki
+    revid, timestamp = get_wikipedia_revision_info(page_title, target_date_str)
+
+    if not revid:
+        print(f"Não foi possível encontrar uma revisão adequada para '{page_title}' em {target_date_str}.")
+        return None
+
+    # Constrói a URL para a revisão específica
+    # Nota: Codifica o título da página para a URL
+    # Precisamos garantir que estamos usando o título correto (pode ter sido redirecionado)
+    page_check = wiki_wiki.page(page_title) # Verifica novamente para obter o título canônico se houve redirecionamento
+    if not page_check.exists():
+         print(f"Erro inesperado: Página '{page_title}' não encontrada após busca de revisão.")
+         return None
+    canonical_title = page_check.title
+    encoded_title = urllib.parse.quote(canonical_title.replace(' ', '_'))
+    revision_url = f"https://{WIKI_LANG}.wikipedia.org/w/index.php?title={encoded_title}&oldid={revid}"
+
+    print(f"Acessando URL da revisão: {revision_url}")
+    # Usa a função de download e conversão para obter o conteúdo em Markdown
+    md_content = download_and_convert_to_md(revision_url)
+
+    if md_content:
+        # Adiciona informação sobre a revisão no início do conteúdo (CORRIGIDO)
+        header = f"# Wikipedia Content for '{canonical_title}'\n"
+        header += f"*Revision from {timestamp} (ID: {revid})*\n"
+        header += f"*Regarding search date: {target_date_str}*\n\n"
+        header += "---\n\n"
+        return header + md_content
+    else:
+        print(f"Falha ao obter ou converter conteúdo da revisão {revid} para '{canonical_title}'.")
+        return None
+
+# --- Função Principal de Busca ---
+
+def search_and_extract(query, use_wikipedia_priority=False, wikipedia_date=None):
+    """Realiza a busca, filtra resultados, baixa e converte conteúdo."""
+    global tavily
+    if not tavily:
+        if not TAVILY_API_KEY or TAVILY_API_KEY == "INSIRA_SUA_CHAVE_TAVILY_AQUI":
+            print("Erro: Chave da API Tavily não configurada ou inválida.")
+            return []
+        try:
+            tavily = TavilyClient(api_key=TAVILY_API_KEY)
+        except Exception as e:
+            print(f"Erro ao inicializar o cliente Tavily: {e}")
+            return []
+
+    results_md = []
+
+    # Sempre faz a busca com Tavily primeiro
+    print(f"\n--- Realizando busca por '{query}' usando Tavily ---")
+    try:
+        response = tavily.search(query=query, search_depth="basic", max_results=10)
+        search_results = response.get('results', [])
+    except Exception as e:
+        print(f"Erro ao realizar busca com Tavily: {e}")
+        return []
+
+    if not search_results:
+        print("Nenhum resultado encontrado pela busca Tavily.")
+        return []
+
+    urls_to_process = []
+    if use_wikipedia_priority:
+        print("Prioridade para Wikipedia habilitada. Filtrando resultados Tavily por Wikipedia...")
+        wiki_urls = [res['url'] for res in search_results if is_wikipedia_url(res['url'])]
+        if wiki_urls:
+            # Pega o primeiro resultado da Wikipedia
+            first_wiki_url = wiki_urls[0]
+            page_title_guess = first_wiki_url.split('/')[-1].replace('_', ' ')
+            page_check = wiki_wiki.page(page_title_guess)
+            if page_check.exists():
+                print(f"Encontrado resultado da Wikipedia: {first_wiki_url}")
+                if wikipedia_date:
+                    # Busca revisão histórica
+                    md_content = get_wikipedia_page_historical_content(page_check.title, wikipedia_date)
+                    if md_content:
+                        results_md.append({
+                            "source": f"Wikipedia Revision ({page_check.title} @ {wikipedia_date})",
+                            "content": md_content
+                        })
+                        return results_md
+                else:
+                    # Usa a URL atual
+                    urls_to_process = [first_wiki_url]
+            else:
+                print(f"Página da Wikipedia '{page_title_guess}' não encontrada. Usando os 5 primeiros resultados gerais.")
+                urls_to_process = [res['url'] for res in search_results[:5]]
+        else:
+            print("Nenhuma URL da Wikipedia encontrada nos resultados. Usando os 5 primeiros resultados gerais.")
+            urls_to_process = [res['url'] for res in search_results[:5]]
+    else:
+        print("Usando os 5 primeiros resultados gerais.")
+        urls_to_process = [res['url'] for res in search_results[:5]]
+
+    print(f"\n--- Processando {len(urls_to_process)} URLs selecionadas ---")
+    for url in urls_to_process:
+        md_content = download_and_convert_to_md(url)
+        if md_content:
+            results_md.append({
+                "source": url,
+                "content": md_content
+            })
+        else:
+            print(f"Falha ao processar URL: {url}")
+
+    return results_md
+
+
+# --- Exemplo de Uso ---
+if __name__ == "__main__":
+    # Verifica se a chave foi definida
+    if not TAVILY_API_KEY or TAVILY_API_KEY == "INSIRA_SUA_CHAVE_TAVILY_AQUI":
+        print("\n!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!")
+        print("!!! Chave da API Tavily não encontrada ou não definida. !!!")
+        print("!!! Verifique a variável TAVILY_API_KEY no início do script. !!!")
+        print("!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n")
+        # exit() # Descomente para parar a execução se a chave não estiver presente
+
+    # Exemplo 1: Busca geral pelos 5 primeiros resultados (em inglês)
+    print("\n================ Example 1: General Search ================")
+    # Usando um tópico mais provável de ter bons resultados em inglês
+    if False:
+        resultados_gerais = search_and_extract("History of Artificial Intelligence")
+        for i, res in enumerate(resultados_gerais):
+            print(f"\nGeneral Result {i+1}: {res['source']}")
+            filename = f"general_result_{i+1}.md"
+            try:
+                with open(filename, "w", encoding="utf-8") as f:
+                    f.write(f"# Source: {res['source']}\n\n")
+                    f.write(res['content'])
+                print(f"Content saved to {filename}")
+            except Exception as e:
+                print(f"Error saving {filename}: {e}")
+            # print(res['content'][:300] + "...") # Mostra um trecho
+
+    # Exemplo 2: Busca com prioridade para Wikipedia (em inglês)
+    print("\n============= Example 2: Wikipedia Priority ============")
+    resultados_wiki = search_and_extract("studio albums published by Mercedes Sosa between.", use_wikipedia_priority=True, wikipedia_date='2022-12-31')
+    for i, res in enumerate(resultados_wiki):
+        print(f"\nWiki Priority Result {i+1}: {res['source']}")
+        filename = f"wiki_priority_result_{i+1}.md"
+        try:
+            with open(filename, "w", encoding="utf-8") as f:
+                f.write(f"# Source: {res['source']}\n\n")
+                f.write(res['content'])
+            print(f"Content saved to {filename}")
+        except Exception as e:
+            print(f"Error saving {filename}: {e}")
+        # print(res['content'][:300] + "...")
+
+    # Exemplo 3: Busca por revisão histórica da Wikipedia (em inglês)
+    print("\n========== Example 3: Historical Wikipedia Revision ==========")
+    # Nota: O título da página deve ser o mais exato possível.
+    # Vamos buscar uma revisão do artigo 'Python (programming language)' perto de 15 Jan 2010
+    if False:
+        resultados_hist = search_and_extract("Python (programming language)", use_wikipedia_priority=True, wikipedia_date="2010-01-15")
+        for i, res in enumerate(resultados_hist):
+            print(f"\nHistorical Result {i+1}: {res['source']}")
+            filename = f"historical_result_python_2010.md"
+            try:
+                with open(filename, "w", encoding="utf-8") as f:
+                    # O cabeçalho já está incluído pela função get_wikipedia_page_historical_content
+                    f.write(res['content'])
+                print(f"Content saved to {filename}")
+            except Exception as e:
+                print(f"Error saving {filename}: {e}")
+            # print(res['content'][:300] + "...")
+
+    print("\nScript finished.")
+

todo (1).md

@@ -0,0 +1,12 @@
+# Todo List - Análise de Vídeo do YouTube
+
+- [ ] Instalar dependências: `yt-dlp`, `opencv-python`, `openai`.
+- [ ] Criar script Python (`video_analyzer.py`) com placeholders para URL, API Key e prompt.
+- [X] Implementar download do vídeo (`yt-dlp`).
+- [X] Implementar extração de frames a cada 5 segundos (`opencv-python`).
+- [X] Implementar codificação de frames para base64.
+- [X] Implementar chamada à API GPT-4o para análise de imagem.
+- [X] Implementar lógica principal e compilação de resultados.
+- [X] Criar arquivo `requirements.txt`.
+- [X] Criar arquivo `README.md` com instruções.
+- [X] Enviar arquivos gerados ao usuário.

todo.md

@@ -0,0 +1,11 @@
+# Tarefa: Criar Script Python de Busca e Extração de Conteúdo
+
+- [ ] 001: Analisar requisitos detalhados (feito)
+- [ ] 002: Selecionar API de busca (Tavily) (feito)
+- [X] 003: Desenvolver funções específicas para Wikipedia (priorização e acesso ao histórico)
+- [X] 004: Implementar extração de conteúdo e conversão para Markdown
+- [X] 005: Adicionar suporte a revisões históricas da Wikipedia por data
+- [X] 006: Integrar componentes no script completo
+- [X] 007: Testar funcionalidade do script
+- [X] 008: Documentar uso do código e entregar
+

video_analyzer.py

@@ -0,0 +1,348 @@
+# -*- coding: utf-8 -*-
+"""
+Script para baixar um vídeo do YouTube, extrair frames, analisar com GPT-4o e contar aves.
+"""
+
+import os
+import subprocess
+import cv2
+import base64
+import time
+from openai import OpenAI # Importa a classe OpenAI
+import json
+import re 
+
+# --- Configurações (Substitua os placeholders) ---
+VIDEO_URL = "https://www.youtube.com/watch?v=L1vXCYZAYYM"  # Substitua pela URL do vídeo do YouTube
+OUTPUT_DIR = "./video_analysis_output" # Diretório para salvar o vídeo e os frames
+FRAME_INTERVAL_SECONDS = 3 # Intervalo entre frames a serem extraídos
+OPENAI_API_KEY = os.getenv("OPENAI_API_KEY")
+GPT_MODEL = "gpt-4o" # Modelo GPT a ser usado (certifique-se que é o correto para análise de imagem)
+PROMPT_TEXT = "Quantas aves existem nesta imagem? Responda apenas com o número." # Prompt para o GPT-4o
+RESULTS_FILE = os.path.join(OUTPUT_DIR, "analysis_results.json")
+VIDEO_FILENAME = "downloaded_video.mp4"
+VIDEO_PATH = os.path.join(OUTPUT_DIR, VIDEO_FILENAME)
+
+# Verifica se a chave da API foi definida
+if OPENAI_API_KEY == "SUA_CHAVE_API_OPENAI_AQUI":
+    print("AVISO: A chave da API OpenAI não foi definida. Por favor, edite o script e insira sua chave.")
+    # Considerar sair do script ou lançar um erro se a chave for essencial para a execução completa
+    # exit(1)
+
+# Verifica se a URL foi definida
+if VIDEO_URL == "URL_DO_SEU_VIDEO_AQUI":
+    print("AVISO: A URL do vídeo não foi definida. Por favor, edite o script e insira a URL desejada.")
+    # exit(1)
+
+# --- Funções ---
+
+def create_output_directory():
+    """Cria o diretório de saída se não existir."""
+    if not os.path.exists(OUTPUT_DIR):
+        os.makedirs(OUTPUT_DIR)
+        print(f"Diretório criado: {OUTPUT_DIR}")
+        
+def retirar_sufixo_codec_arquivo(directory) -> None:
+    for filename in os.listdir(directory):
+        # Procura padrão como ".f123" antes da extensão
+        new_filename = re.sub(r'\.f\d{3}(?=\.\w+$)', '', filename)
+        if new_filename != filename:
+            old_path = os.path.join(directory, filename)
+            new_path = os.path.join(directory, new_filename)
+            os.rename(old_path, new_path)
+            print(f"Renomeado: {filename} → {new_filename}")
+            
+
+def download_video(url, output_path):
+    """Baixa o vídeo do YouTube usando yt-dlp."""
+    print(f"Baixando vídeo de {url} para {output_path}...")
+    try:
+        # Comando yt-dlp para baixar o melhor formato mp4
+        command = [
+            'yt-dlp',
+            '-f', 'bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best',
+            '-o', output_path,
+            url
+        ]
+        result = subprocess.run(command, check=True, capture_output=True, text=True)
+        print("Download concluído com sucesso.")
+        retirar_sufixo_codec_arquivo(OUTPUT_DIR)
+        # print(result.stdout) # Descomente para ver a saída do yt-dlp
+        return True
+    except subprocess.CalledProcessError as e:
+        print(f"Erro ao baixar o vídeo: {e}")
+        print(f"Saída do erro: {e.stderr}")
+        return False
+    except FileNotFoundError:
+        print("Erro: O comando 'yt-dlp' não foi encontrado. Certifique-se de que ele está instalado e no PATH do sistema.")
+        print("Você pode instalá-lo com: pip install yt-dlp")
+        return False
+
+
+def extract_frames(video_path, output_dir, interval_sec):
+    """Extrai frames de um vídeo em intervalos específicos."""
+    print(f"Extraindo frames de {video_path} a cada {interval_sec} segundos...")
+    if not os.path.exists(video_path):
+        print(f"Erro: Arquivo de vídeo não encontrado em {video_path}")
+        return []
+
+    cap = cv2.VideoCapture(video_path)
+    if not cap.isOpened():
+        print(f"Erro ao abrir o arquivo de vídeo: {video_path}")
+        return []
+
+    fps = cap.get(cv2.CAP_PROP_FPS)
+    if fps == 0:
+        print("Erro: Não foi possível obter o FPS do vídeo. Usando FPS padrão de 30.")
+        fps = 30 # Valor padrão caso a leitura falhe
+
+    frame_interval = int(fps * interval_sec)
+    total_frames = int(cap.get(cv2.CAP_PROP_FRAME_COUNT))
+    print(f"Vídeo FPS: {fps:.2f}, Intervalo de frames: {frame_interval}, Total de frames: {total_frames}")
+
+    extracted_frames_paths = []
+    frame_count = 0
+    saved_frame_index = 5 # o importante nunca começa no inicio, é um deslocamento inicial para iniciar depois da introdução
+
+
+    while True:
+        # Define a posição do próximo frame a ser lido
+        # Adiciona frame_interval para pegar o frame *após* o intervalo de tempo
+        target_frame_pos = saved_frame_index * frame_interval
+        if target_frame_pos >= total_frames:
+            break # Sai se o próximo frame alvo estiver além do final do vídeo
+
+        cap.set(cv2.CAP_PROP_POS_FRAMES, target_frame_pos)
+        ret, frame = cap.read()
+
+        if not ret:
+            print(f"Não foi possível ler o frame na posição {target_frame_pos}. Pode ser o fim do vídeo ou um erro.")
+            break # Sai se não conseguir ler o frame
+
+        # redimensiona o frame (custo chamada)
+        frame = cv2.resize(frame, (1280, 720))
+        
+        # Calcula o timestamp em segundos
+        timestamp_sec = target_frame_pos / fps
+
+        # Salva o frame
+        frame_filename = f"frame_{saved_frame_index:04d}_time_{timestamp_sec:.2f}s.png"
+        frame_path = os.path.join(output_dir, frame_filename)
+        try:
+            cv2.imwrite(frame_path, frame)
+            extracted_frames_paths.append(frame_path)
+            print(f"Frame salvo: {frame_path} (Timestamp: {timestamp_sec:.2f}s)")
+            saved_frame_index += 1
+        except Exception as e:
+            print(f"Erro ao salvar o frame {frame_path}: {e}")
+            # Continua para o próximo intervalo mesmo se um frame falhar
+
+        # Segurança para evitar loop infinito caso algo dê errado com a lógica de posição
+        if saved_frame_index > (total_frames / frame_interval) + 2:
+             print("Aviso: Número de frames salvos parece exceder o esperado. Interrompendo extração.")
+             break
+
+    cap.release()
+    print(f"Extração de frames concluída. Total de frames salvos: {len(extracted_frames_paths)}")
+    return extracted_frames_paths
+
+# --- Atualização do Bloco Principal ---
+# (Remover a linha print anterior sobre próximas etapas e adicionar a chamada da nova função)
+
+
+
+
+def encode_frame_to_base64(frame_path):
+    """Codifica um arquivo de imagem (frame) para base64."""
+    try:
+        with open(frame_path, "rb") as image_file:
+            return base64.b64encode(image_file.read()).decode('utf-8')
+    except FileNotFoundError:
+        print(f"Erro: Arquivo de frame não encontrado em {frame_path}")
+        return None
+    except Exception as e:
+        print(f"Erro ao codificar o frame {frame_path} para base64: {e}")
+        return None
+
+
+
+def analyze_frame_with_gpt4o(client, base64_image, prompt):
+    print("NAO CHAMAR AINDA")
+    return 
+
+    """Envia um frame codificado em base64 para a API GPT-4o e retorna a análise."""
+    print(f"Enviando frame para análise no {GPT_MODEL}...")
+    headers = {
+        "Content-Type": "application/json",
+        "Authorization": f"Bearer {OPENAI_API_KEY}"
+    }
+
+    payload = {
+        "model": GPT_MODEL,
+        "messages": [
+            {
+                "role": "user",
+                "content": [
+                    {
+                        "type": "text",
+                        "text": prompt
+                    },
+                    {
+                        "type": "image_url",
+                        "image_url": {
+                            "url": f"data:image/png;base64,{base64_image}"
+                        }
+                    }
+                ]
+            }
+        ],
+        "max_tokens": 100 # Ajuste conforme necessário para a resposta esperada
+    }
+
+    try:
+        # Verifica se a chave da API é o placeholder
+        if OPENAI_API_KEY == "SUA_CHAVE_API_OPENAI_AQUI":
+             print("AVISO: Chave da API OpenAI não configurada. Pulando análise.")
+             return {"error": "API key not configured."}
+
+        # Cria o cliente OpenAI dentro da função para garantir que use a chave mais recente
+        # (embora seja definida globalmente, isso pode ser útil se a chave for atualizada dinamicamente no futuro)
+        # client = OpenAI(api_key=OPENAI_API_KEY)
+
+        response = client.chat.completions.create(
+            model=payload["model"],
+            messages=payload["messages"],
+            max_tokens=payload["max_tokens"]
+        )
+
+        # Extrai o conteúdo da resposta
+        analysis_result = response.choices[0].message.content.strip()
+        print(f"Análise recebida: {analysis_result}")
+        # Tenta converter a resposta para um inteiro (contagem de aves)
+        try:
+            bird_count = int(analysis_result)
+            return {"bird_count": bird_count, "raw_response": analysis_result}
+        except ValueError:
+            print(f"Aviso: Não foi possível converter a resposta '{analysis_result}' para um número inteiro.")
+            return {"error": "Failed to parse bird count from response.", "raw_response": analysis_result}
+
+    except Exception as e:
+        print(f"Erro ao chamar a API OpenAI: {e}")
+        return {"error": str(e)}
+    
+def save_results_to_json(results_list, output_file):
+    """Salva a lista de resultados da análise em um arquivo JSON."""
+    print(f"Salvando resultados da análise em {output_file}...")
+    try:
+        with open(output_file, 'w', encoding='utf-8') as f:
+            json.dump(results_list, f, ensure_ascii=False, indent=4)
+        print(f"Resultados salvos com sucesso em: {output_file}")
+        return True
+    except Exception as e:
+        print(f"Erro ao salvar os resultados em JSON: {e}")
+        return False
+    
+
+# --- Atualização do Bloco Principal --- 
+# (Adicionar inicialização do cliente OpenAI e o loop de análise)
+if __name__ == "__main__":
+    create_output_directory()
+    extracted_frames = []
+    analysis_results_list = []
+
+    # Inicializa o cliente OpenAI (se a chave estiver definida)
+    openai_client = None
+    if OPENAI_API_KEY != "SUA_CHAVE_API_OPENAI_AQUI":
+        try:
+            openai_client = OpenAI(api_key=OPENAI_API_KEY)
+            print("Cliente OpenAI inicializado.")
+        except Exception as e:
+            print(f"Erro ao inicializar o cliente OpenAI: {e}. As chamadas de API serão puladas.")
+    else:
+        print("Chave da API OpenAI não configurada. As chamadas de API serão puladas.")
+
+    # Etapa 1: Baixar o vídeo
+    video_downloaded_or_exists = False
+    if VIDEO_URL != "URL_DO_SEU_VIDEO_AQUI":
+        if download_video(VIDEO_URL, VIDEO_PATH):
+            print(f"Vídeo salvo em: {VIDEO_PATH}")
+            video_downloaded_or_exists = True
+        else:
+            print("Falha no download do vídeo. Pulando etapas dependentes.")
+    elif os.path.exists(VIDEO_PATH):
+         print(f"URL não fornecida, mas vídeo encontrado em {VIDEO_PATH}. Tentando processar.")
+         video_downloaded_or_exists = True
+    else:
+        print("URL do vídeo não fornecida e vídeo local não encontrado. Pulando download e extração.")
+
+    # Etapa 2: Extrair frames
+    if video_downloaded_or_exists:
+        extracted_frames = extract_frames(VIDEO_PATH, OUTPUT_DIR, FRAME_INTERVAL_SECONDS)
+    else:
+        print("Pulando extração de frames pois o vídeo não está disponível.")
+
+    # Etapa 3 e 4: Codificar e Analisar Frames
+    if extracted_frames and openai_client:
+        print(f"\nIniciando análise de {len(extracted_frames)} frames com {GPT_MODEL}...")
+        for frame_path in extracted_frames:
+            print(f"\nProcessando frame: {frame_path}")
+            # Extrai timestamp do nome do arquivo, se possível
+            timestamp_str = "unknown"
+            try:
+                # Exemplo: frame_0000_time_0.00s.png
+                parts = os.path.basename(frame_path).split('_')
+                if len(parts) >= 4 and parts[2] == 'time':
+                   timestamp_str = parts[3].replace('s.png','')
+            except Exception:
+                pass # Mantém 'unknown' se o parsing falhar
+
+            # Codifica o frame
+            base64_image = encode_frame_to_base64(frame_path)
+            
+            if base64_image:
+                # Analisa o frame com GPT-4o
+                # analysis_result = analyze_frame_with_gpt4o(openai_client, base64_image, PROMPT_TEXT)
+                result_entry = {
+                    "frame_path": frame_path,
+                    "timestamp_approx_sec": timestamp_str,
+                    "analysis": f' pulado frame {frame_path}' #analysis_result
+                }
+                analysis_results_list.append(result_entry)
+
+                # Pausa opcional para evitar rate limiting
+                time.sleep(1) # Pausa de 1 segundo entre as chamadas
+            else:
+                print(f"Falha ao codificar o frame {frame_path}. Pulando análise.")
+                analysis_results_list.append({
+                    "frame_path": frame_path,
+                    "timestamp_approx_sec": timestamp_str,
+                    "analysis": {"error": "Failed to encode frame to base64."}
+                })
+        print("\nAnálise de todos os frames concluída.")
+    elif not extracted_frames:
+        print("Nenhum frame foi extraído. Pulando etapa de análise.")
+    elif not openai_client:
+        print("Cliente OpenAI não inicializado (verifique a API Key). Pulando etapa de análise.")
+
+    # Próxima etapa: Compilar resultados
+    print(f"\nPróxima etapa a ser implementada: Compilação dos resultados ({len(analysis_results_list)} análises) em um relatório.")
+
+
+    # ... (código anterior para inicialização, download, extração, análise) ...
+
+    # Etapa 5: Compilar e Salvar Resultados
+    if analysis_results_list:
+        print(f"\nCompilando {len(analysis_results_list)} resultados da análise...")
+        if save_results_to_json(analysis_results_list, RESULTS_FILE):
+            print("Compilação e salvamento dos resultados concluídos.")
+        else:
+            print("Falha ao salvar os resultados da análise.")
+    else:
+        print("Nenhum resultado de análise para compilar.")
+
+    print("\n--- Processo de Análise de Vídeo Concluído ---")
+    print(f"Verifique o diretório '{OUTPUT_DIR}' para os frames extraídos (se aplicável).")
+    print(f"Verifique o arquivo '{RESULTS_FILE}' para os resultados da análise (se aplicável).")
+    print("Lembre-se de substituir os placeholders para URL_DO_SEU_VIDEO_AQUI e SUA_CHAVE_API_OPENAI_AQUI no script.")
+
+

video_analyzer_temp.py

@@ -0,0 +1,391 @@
+# -*- coding: utf-8 -*-
+"""
+Script para baixar um vídeo do YouTube, extrair frames, analisar com GPT-4o e contar aves.
+"""
+
+import os
+import subprocess
+import cv2
+import base64
+import time
+from openai import OpenAI # Importa a classe OpenAI
+import json
+
+# --- Configurações (Substitua os placeholders) ---
+VIDEO_URL = "URL_DO_SEU_VIDEO_AQUI"  # Substitua pela URL do vídeo do YouTube
+OUTPUT_DIR = "./video_analysis_output" # Diretório para salvar o vídeo e os frames
+FRAME_INTERVAL_SECONDS = 5 # Intervalo entre frames a serem extraídos
+OPENAI_API_KEY = "SUA_CHAVE_API_OPENAI_AQUI" # Substitua pela sua chave da API OpenAI
+GPT_MODEL = "gpt-4o" # Modelo GPT a ser usado (certifique-se que é o correto para análise de imagem)
+PROMPT_TEXT = "Quantas aves existem nesta imagem? Responda apenas com o número." # Prompt para o GPT-4o
+RESULTS_FILE = os.path.join(OUTPUT_DIR, "analysis_results.json")
+VIDEO_FILENAME = "downloaded_video.mp4"
+VIDEO_PATH = os.path.join(OUTPUT_DIR, VIDEO_FILENAME)
+
+# Verifica se a chave da API foi definida
+if OPENAI_API_KEY == "SUA_CHAVE_API_OPENAI_AQUI":
+    print("AVISO: A chave da API OpenAI não foi definida. Por favor, edite o script e insira sua chave.")
+    # Considerar sair do script ou lançar um erro se a chave for essencial para a execução completa
+    # exit(1)
+
+# Verifica se a URL foi definida
+if VIDEO_URL == "URL_DO_SEU_VIDEO_AQUI":
+    print("AVISO: A URL do vídeo não foi definida. Por favor, edite o script e insira a URL desejada.")
+    # exit(1)
+
+# --- Funções ---
+
+def create_output_directory():
+    """Cria o diretório de saída se não existir."""
+    if not os.path.exists(OUTPUT_DIR):
+        os.makedirs(OUTPUT_DIR)
+        print(f"Diretório criado: {OUTPUT_DIR}")
+
+def download_video(url, output_path):
+    """Baixa o vídeo do YouTube usando yt-dlp."""
+    print(f"Baixando vídeo de {url} para {output_path}...")
+    try:
+        # Comando yt-dlp para baixar o melhor formato mp4
+        command = [
+            'yt-dlp',
+            '-f', 'bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best',
+            '-o', output_path,
+            url
+        ]
+        result = subprocess.run(command, check=True, capture_output=True, text=True)
+        print("Download concluído com sucesso.")
+        # print(result.stdout) # Descomente para ver a saída do yt-dlp
+        return True
+    except subprocess.CalledProcessError as e:
+        print(f"Erro ao baixar o vídeo: {e}")
+        print(f"Saída do erro: {e.stderr}")
+        return False
+    except FileNotFoundError:
+        print("Erro: O comando 'yt-dlp' não foi encontrado. Certifique-se de que ele está instalado e no PATH do sistema.")
+        print("Você pode instalá-lo com: pip install yt-dlp")
+        return False
+
+# --- Bloco Principal (Inicial) ---
+if __name__ == "__main__":
+    create_output_directory()
+
+    # Etapa 1: Baixar o vídeo
+    if VIDEO_URL != "URL_DO_SEU_VIDEO_AQUI":
+        if not download_video(VIDEO_URL, VIDEO_PATH):
+            print("Falha no download do vídeo. Abortando.")
+            # exit(1) # Descomente se quiser que o script pare aqui em caso de falha no download
+        else:
+            print(f"Vídeo salvo em: {VIDEO_PATH}")
+    else:
+        print("URL do vídeo não fornecida. Pulando etapa de download.")
+        print("Certifique-se de que o arquivo 'downloaded_video.mp4' existe em '{OUTPUT_DIR}' se quiser continuar.")
+
+    # Próximas etapas (extração de frames, análise, etc.) serão adicionadas aqui
+    print("\nPróximas etapas a serem implementadas: extração de frames, análise com GPT-4o, compilação de resultados.")
+
+
+
+
+def extract_frames(video_path, output_dir, interval_sec):
+    """Extrai frames de um vídeo em intervalos específicos."""
+    print(f"Extraindo frames de {video_path} a cada {interval_sec} segundos...")
+    if not os.path.exists(video_path):
+        print(f"Erro: Arquivo de vídeo não encontrado em {video_path}")
+        return []
+
+    cap = cv2.VideoCapture(video_path)
+    if not cap.isOpened():
+        print(f"Erro ao abrir o arquivo de vídeo: {video_path}")
+        return []
+
+    fps = cap.get(cv2.CAP_PROP_FPS)
+    if fps == 0:
+        print("Erro: Não foi possível obter o FPS do vídeo. Usando FPS padrão de 30.")
+        fps = 30 # Valor padrão caso a leitura falhe
+
+    frame_interval = int(fps * interval_sec)
+    total_frames = int(cap.get(cv2.CAP_PROP_FRAME_COUNT))
+    print(f"Vídeo FPS: {fps:.2f}, Intervalo de frames: {frame_interval}, Total de frames: {total_frames}")
+
+    extracted_frames_paths = []
+    frame_count = 0
+    saved_frame_index = 0
+
+    while True:
+        # Define a posição do próximo frame a ser lido
+        # Adiciona frame_interval para pegar o frame *após* o intervalo de tempo
+        target_frame_pos = saved_frame_index * frame_interval
+        if target_frame_pos >= total_frames:
+            break # Sai se o próximo frame alvo estiver além do final do vídeo
+
+        cap.set(cv2.CAP_PROP_POS_FRAMES, target_frame_pos)
+        ret, frame = cap.read()
+
+        if not ret:
+            print(f"Não foi possível ler o frame na posição {target_frame_pos}. Pode ser o fim do vídeo ou um erro.")
+            break # Sai se não conseguir ler o frame
+
+        # Calcula o timestamp em segundos
+        timestamp_sec = target_frame_pos / fps
+
+        # Salva o frame
+        frame_filename = f"frame_{saved_frame_index:04d}_time_{timestamp_sec:.2f}s.png"
+        frame_path = os.path.join(output_dir, frame_filename)
+        try:
+            cv2.imwrite(frame_path, frame)
+            extracted_frames_paths.append(frame_path)
+            print(f"Frame salvo: {frame_path} (Timestamp: {timestamp_sec:.2f}s)")
+            saved_frame_index += 1
+        except Exception as e:
+            print(f"Erro ao salvar o frame {frame_path}: {e}")
+            # Continua para o próximo intervalo mesmo se um frame falhar
+
+        # Segurança para evitar loop infinito caso algo dê errado com a lógica de posição
+        if saved_frame_index > (total_frames / frame_interval) + 2:
+             print("Aviso: Número de frames salvos parece exceder o esperado. Interrompendo extração.")
+             break
+
+    cap.release()
+    print(f"Extração de frames concluída. Total de frames salvos: {len(extracted_frames_paths)}")
+    return extracted_frames_paths
+
+# --- Atualização do Bloco Principal ---
+# (Remover a linha print anterior sobre próximas etapas e adicionar a chamada da nova função)
+
+
+
+
+def encode_frame_to_base64(frame_path):
+    """Codifica um arquivo de imagem (frame) para base64."""
+    try:
+        with open(frame_path, "rb") as image_file:
+            return base64.b64encode(image_file.read()).decode('utf-8')
+    except FileNotFoundError:
+        print(f"Erro: Arquivo de frame não encontrado em {frame_path}")
+        return None
+    except Exception as e:
+        print(f"Erro ao codificar o frame {frame_path} para base64: {e}")
+        return None
+
+# --- Atualização do Bloco Principal ---
+# (Remover a linha print anterior sobre próximas etapas e adicionar a chamada da nova função)
+if __name__ == "__main__":
+    create_output_directory()
+    extracted_frames = [] # Inicializa a lista de frames extraídos
+
+    # Etapa 1: Baixar o vídeo
+    if VIDEO_URL != "URL_DO_SEU_VIDEO_AQUI":
+        if not download_video(VIDEO_URL, VIDEO_PATH):
+            print("Falha no download do vídeo. Pulando etapas dependentes.")
+            # Considerar sair se o vídeo for essencial
+            # exit(1)
+        else:
+            print(f"Vídeo salvo em: {VIDEO_PATH}")
+            # Etapa 2: Extrair frames (só executa se o download foi bem-sucedido ou se a URL não foi fornecida mas o vídeo existe)
+            if os.path.exists(VIDEO_PATH):
+                 extracted_frames = extract_frames(VIDEO_PATH, OUTPUT_DIR, FRAME_INTERVAL_SECONDS)
+            else:
+                 print(f"Arquivo de vídeo {VIDEO_PATH} não encontrado após tentativa de download. Pulando extração de frames.")
+
+    elif os.path.exists(VIDEO_PATH):
+         print(f"URL não fornecida, mas vídeo encontrado em {VIDEO_PATH}. Tentando extrair frames.")
+         extracted_frames = extract_frames(VIDEO_PATH, OUTPUT_DIR, FRAME_INTERVAL_SECONDS)
+    else:
+        print("URL do vídeo não fornecida e vídeo local não encontrado. Pulando download e extração de frames.")
+        print(f"Certifique-se de que o arquivo '{VIDEO_FILENAME}' existe em '{OUTPUT_DIR}' para processamento manual.")
+
+    # Etapa 3: Codificar frames para base64 (será usado na próxima etapa de análise)
+    if extracted_frames:
+        print(f"\nIniciando codificação de {len(extracted_frames)} frames para base64...")
+        # A codificação será feita dentro do loop de análise na próxima etapa
+        # para otimizar o uso de memória, processando um frame por vez.
+        print("Codificação será realizada frame a frame antes do envio para a API.")
+    else:
+        print("Nenhum frame foi extraído. Pulando etapas de codificação e análise.")
+
+    # Próxima etapa: Enviar frames para GPT-4o
+    print("\nPróxima etapa a ser implementada: Envio dos frames (codificados em base64) para análise com GPT-4o.")
+
+
+
+
+def analyze_frame_with_gpt4o(client, base64_image, prompt):
+    """Envia um frame codificado em base64 para a API GPT-4o e retorna a análise."""
+    print(f"Enviando frame para análise no {GPT_MODEL}...")
+    headers = {
+        "Content-Type": "application/json",
+        "Authorization": f"Bearer {OPENAI_API_KEY}"
+    }
+
+    payload = {
+        "model": GPT_MODEL,
+        "messages": [
+            {
+                "role": "user",
+                "content": [
+                    {
+                        "type": "text",
+                        "text": prompt
+                    },
+                    {
+                        "type": "image_url",
+                        "image_url": {
+                            "url": f"data:image/png;base64,{base64_image}"
+                        }
+                    }
+                ]
+            }
+        ],
+        "max_tokens": 100 # Ajuste conforme necessário para a resposta esperada
+    }
+
+    try:
+        # Verifica se a chave da API é o placeholder
+        if OPENAI_API_KEY == "SUA_CHAVE_API_OPENAI_AQUI":
+             print("AVISO: Chave da API OpenAI não configurada. Pulando análise.")
+             return {"error": "API key not configured."}
+
+        # Cria o cliente OpenAI dentro da função para garantir que use a chave mais recente
+        # (embora seja definida globalmente, isso pode ser útil se a chave for atualizada dinamicamente no futuro)
+        # client = OpenAI(api_key=OPENAI_API_KEY)
+
+        response = client.chat.completions.create(
+            model=payload["model"],
+            messages=payload["messages"],
+            max_tokens=payload["max_tokens"]
+        )
+
+        # Extrai o conteúdo da resposta
+        analysis_result = response.choices[0].message.content.strip()
+        print(f"Análise recebida: {analysis_result}")
+        # Tenta converter a resposta para um inteiro (contagem de aves)
+        try:
+            bird_count = int(analysis_result)
+            return {"bird_count": bird_count, "raw_response": analysis_result}
+        except ValueError:
+            print(f"Aviso: Não foi possível converter a resposta '{analysis_result}' para um número inteiro.")
+            return {"error": "Failed to parse bird count from response.", "raw_response": analysis_result}
+
+    except Exception as e:
+        print(f"Erro ao chamar a API OpenAI: {e}")
+        return {"error": str(e)}
+
+# --- Atualização do Bloco Principal --- 
+# (Adicionar inicialização do cliente OpenAI e o loop de análise)
+if __name__ == "__main__":
+    create_output_directory()
+    extracted_frames = []
+    analysis_results_list = []
+
+    # Inicializa o cliente OpenAI (se a chave estiver definida)
+    openai_client = None
+    if OPENAI_API_KEY != "SUA_CHAVE_API_OPENAI_AQUI":
+        try:
+            openai_client = OpenAI(api_key=OPENAI_API_KEY)
+            print("Cliente OpenAI inicializado.")
+        except Exception as e:
+            print(f"Erro ao inicializar o cliente OpenAI: {e}. As chamadas de API serão puladas.")
+    else:
+        print("Chave da API OpenAI não configurada. As chamadas de API serão puladas.")
+
+    # Etapa 1: Baixar o vídeo
+    video_downloaded_or_exists = False
+    if VIDEO_URL != "URL_DO_SEU_VIDEO_AQUI":
+        if download_video(VIDEO_URL, VIDEO_PATH):
+            print(f"Vídeo salvo em: {VIDEO_PATH}")
+            video_downloaded_or_exists = True
+        else:
+            print("Falha no download do vídeo. Pulando etapas dependentes.")
+    elif os.path.exists(VIDEO_PATH):
+         print(f"URL não fornecida, mas vídeo encontrado em {VIDEO_PATH}. Tentando processar.")
+         video_downloaded_or_exists = True
+    else:
+        print("URL do vídeo não fornecida e vídeo local não encontrado. Pulando download e extração.")
+
+    # Etapa 2: Extrair frames
+    if video_downloaded_or_exists:
+        extracted_frames = extract_frames(VIDEO_PATH, OUTPUT_DIR, FRAME_INTERVAL_SECONDS)
+    else:
+        print("Pulando extração de frames pois o vídeo não está disponível.")
+
+    # Etapa 3 e 4: Codificar e Analisar Frames
+    if extracted_frames and openai_client:
+        print(f"\nIniciando análise de {len(extracted_frames)} frames com {GPT_MODEL}...")
+        for frame_path in extracted_frames:
+            print(f"\nProcessando frame: {frame_path}")
+            # Extrai timestamp do nome do arquivo, se possível
+            timestamp_str = "unknown"
+            try:
+                # Exemplo: frame_0000_time_0.00s.png
+                parts = os.path.basename(frame_path).split('_')
+                if len(parts) >= 4 and parts[2] == 'time':
+                   timestamp_str = parts[3].replace('s.png','')
+            except Exception:
+                pass # Mantém 'unknown' se o parsing falhar
+
+            # Codifica o frame
+            base64_image = encode_frame_to_base64(frame_path)
+
+            if base64_image:
+                # Analisa o frame com GPT-4o
+                analysis_result = analyze_frame_with_gpt4o(openai_client, base64_image, PROMPT_TEXT)
+                result_entry = {
+                    "frame_path": frame_path,
+                    "timestamp_approx_sec": timestamp_str,
+                    "analysis": analysis_result
+                }
+                analysis_results_list.append(result_entry)
+
+                # Pausa opcional para evitar rate limiting
+                time.sleep(1) # Pausa de 1 segundo entre as chamadas
+            else:
+                print(f"Falha ao codificar o frame {frame_path}. Pulando análise.")
+                analysis_results_list.append({
+                    "frame_path": frame_path,
+                    "timestamp_approx_sec": timestamp_str,
+                    "analysis": {"error": "Failed to encode frame to base64."}
+                })
+        print("\nAnálise de todos os frames concluída.")
+    elif not extracted_frames:
+        print("Nenhum frame foi extraído. Pulando etapa de análise.")
+    elif not openai_client:
+        print("Cliente OpenAI não inicializado (verifique a API Key). Pulando etapa de análise.")
+
+    # Próxima etapa: Compilar resultados
+    print(f"\nPróxima etapa a ser implementada: Compilação dos resultados ({len(analysis_results_list)} análises) em um relatório.")
+
+
+
+
+def save_results_to_json(results_list, output_file):
+    """Salva a lista de resultados da análise em um arquivo JSON."""
+    print(f"Salvando resultados da análise em {output_file}...")
+    try:
+        with open(output_file, 'w', encoding='utf-8') as f:
+            json.dump(results_list, f, ensure_ascii=False, indent=4)
+        print(f"Resultados salvos com sucesso em: {output_file}")
+        return True
+    except Exception as e:
+        print(f"Erro ao salvar os resultados em JSON: {e}")
+        return False
+
+# --- Finalização do Bloco Principal ---
+if __name__ == "__main__":
+    # ... (código anterior para inicialização, download, extração, análise) ...
+
+    # Etapa 5: Compilar e Salvar Resultados
+    if analysis_results_list:
+        print(f"\nCompilando {len(analysis_results_list)} resultados da análise...")
+        if save_results_to_json(analysis_results_list, RESULTS_FILE):
+            print("Compilação e salvamento dos resultados concluídos.")
+        else:
+            print("Falha ao salvar os resultados da análise.")
+    else:
+        print("Nenhum resultado de análise para compilar.")
+
+    print("\n--- Processo de Análise de Vídeo Concluído ---")
+    print(f"Verifique o diretório '{OUTPUT_DIR}' para os frames extraídos (se aplicável).")
+    print(f"Verifique o arquivo '{RESULTS_FILE}' para os resultados da análise (se aplicável).")
+    print("Lembre-se de substituir os placeholders para URL_DO_SEU_VIDEO_AQUI e SUA_CHAVE_API_OPENAI_AQUI no script.")
+
+

wiki_priority_result_1.md

@@ -0,0 +1,176 @@
+# Source: Wikipedia Revision (Mercedes Sosa @ 2022-12-31)
+
+# Wikipedia Content for 'Mercedes Sosa'
+*Revision from 2022-12-09T22:29:41Z (ID: 1126540422)*
+*Regarding search date: 2022-12-31*
+
+---
+
+# Mercedes Sosa - Wikipedia
+
+Argentine singer (1935–2009)
+
+**Haydée Mercedes Sosa** ([Template:IPA-es](/w/index.php?title=Template:IPA-es&action=edit&redlink=1 "Template:IPA-es (page does not exist)"); 9 July 1935[[1]](#cite_note-birth-1) – 4 October 2009), sometimes known as ***La Negra*** (lit. 'The Black One', an affectionate nickname for people with a darker complexion in Argentina), was an Argentine singer who was popular throughout Latin America and many countries outside the region. With her roots in Argentine [folk music](/wiki/Folk_music "Folk music"), Sosa became one of the preeminent exponents of *El nuevo cancionero*. She gave voice to songs written by many Latin American songwriters. Her music made people hail her as the "voice of the voiceless ones".[[2]](#cite_note-tmc-2)
+
+Sosa performed in venues such as the [Lincoln Center](/wiki/Lincoln_Center "Lincoln Center") in New York City, the [Théâtre Mogador](/wiki/Th%C3%A9%C3%A2tre_Mogador "Théâtre Mogador") in Paris and the [Sistine Chapel](/wiki/Sistine_Chapel "Sistine Chapel") in Vatican City, as well as sell-out shows in New York's [Carnegie Hall](/wiki/Carnegie_Hall "Carnegie Hall") and the Roman [Colosseum](/wiki/Colosseum "Colosseum") during her final decade of life. Her career spanned four decades and she was the recipient of six [Latin Grammy](/wiki/Latin_Grammy "Latin Grammy") awards (2000, 2003, 2004, 2006, 2009, 2011), including a [Latin Grammy Lifetime Achievement Award](/wiki/Latin_Grammy_Lifetime_Achievement_Award "Latin Grammy Lifetime Achievement Award") in 2004 and two posthumous [Latin Grammy Award for Best Folk Album](/wiki/Latin_Grammy_Award_for_Best_Folk_Album "Latin Grammy Award for Best Folk Album") in 2009 and 2011. She won the [Premio Gardel](/wiki/Premios_Gardel "Premios Gardel") in 2000, the main musical award in Argentina. She served as an ambassador for [UNICEF](/wiki/UNICEF "UNICEF").
+
+## Life
+
+Sosa was born on 9 July 1935, in [San Miguel de Tucumán](/wiki/San_Miguel_de_Tucum%C3%A1n "San Miguel de Tucumán"), in the northwestern Argentine province of [Tucumán](/wiki/Tucum%C3%A1n_Province "Tucumán Province"), of [mestizo](/wiki/Mestizo "Mestizo") ancestry. She was of French, Spanish and [Diaguita](/wiki/Diaguita "Diaguita") descent.[[3]](#cite_note-Legendary_folk_singer_Mercedes_Sosa_dies_at_74-3) Her parents were [Peronists](/wiki/Peronism "Peronism"), although they never registered in the party, and she started her career as a singer for the Peronist Party in Provincia Tucuman under the name Gladys Osorio.[[4]](#cite_note-4) In 1950, at age fifteen, she won a singing competition organized by a local radio station and was given a contract to perform for two months.[[5]](#cite_note-Mercedes_Sosa:_Obituary-5) She recorded her first album, *La Voz de la Zafra*, in 1959.[[5]](#cite_note-Mercedes_Sosa:_Obituary-5) A performance at the 1965 [Cosquín National Folklore Festival](/wiki/Cosqu%C3%ADn_Festival "Cosquín Festival")—where she was introduced and brought to the stage while sitting in the audience by fellow folk singer [Jorge Cafrune](/wiki/Jorge_Cafrune "Jorge Cafrune")—[[6]](#cite_note-test-6) brought her to the attention of the Argentine public.[[5]](#cite_note-Mercedes_Sosa:_Obituary-5)
+
+[![](//upload.wikimedia.org/wikipedia/commons/thumb/d/d8/Mercedes_Sosa%2C_F%C3%A9lix_Luna_y_Ariel_Ram%C3%ADrez.jpg/250px-Mercedes_Sosa%2C_F%C3%A9lix_Luna_y_Ariel_Ram%C3%ADrez.jpg)](/wiki/File:Mercedes_Sosa,_F%C3%A9lix_Luna_y_Ariel_Ram%C3%ADrez.jpg)
+
+Sosa with [Félix Luna](/wiki/F%C3%A9lix_Luna "Félix Luna") and [Ariel Ramírez](/wiki/Ariel_Ram%C3%ADrez "Ariel Ramírez") (at the piano)
+
+Sosa and her first husband, Manuel Oscar Matus, with whom she had one son, were key players in the mid-60s *[nueva canción](/wiki/Nueva_canci%C3%B3n "Nueva canción")* movement (which was called *nuevo cancionero* in Argentina).[[7]](#cite_note-Latin_artist_Mercedes_Sosa_dies-7) Her second record was *Canciones con Fundamento*, a collection of Argentine folk songs.
+
+In 1967, Sosa toured the United States and Europe with great success. In later years, she performed and recorded extensively, broadening her repertoire to include material from throughout Latin America.
+
+In the early 1970s, Sosa released two concept albums in collaboration with composer [Ariel Ramírez](/wiki/Ariel_Ram%C3%ADrez "Ariel Ramírez") and lyricist [Félix Luna](/wiki/F%C3%A9lix_Luna "Félix Luna"): *Cantata Sudamericana* and *Mujeres Argentinas* (Argentine Women). She also recorded a tribute to Chilean musician [Violeta Parra](/wiki/Violeta_Parra "Violeta Parra") in 1971, including what was to become one of Sosa's signature songs, *[Gracias a la Vida](/wiki/Gracias_a_la_Vida "Gracias a la Vida")*.[[3]](#cite_note-Legendary_folk_singer_Mercedes_Sosa_dies_at_74-3)[[8]](#cite_note-ap-8) She also increased the popularity of songs written by [Milton Nascimento](/wiki/Milton_Nascimento "Milton Nascimento") of Brazil and [Pablo Milanés](/wiki/Pablo_Milan%C3%A9s "Pablo Milanés") and [Silvio Rodríguez](/wiki/Silvio_Rodr%C3%ADguez "Silvio Rodríguez") both from [Cuba](/wiki/Cuba "Cuba").[[3]](#cite_note-Legendary_folk_singer_Mercedes_Sosa_dies_at_74-3)
+
+[![](//upload.wikimedia.org/wikipedia/commons/thumb/6/65/Mercedes_Sosa_2.jpg/250px-Mercedes_Sosa_2.jpg)](/wiki/File:Mercedes_Sosa_2.jpg)
+
+Sosa in 1972
+
+After the [military junta](/wiki/National_Reorganization_Process "National Reorganization Process") of [Jorge Videla](/wiki/Jorge_Videla "Jorge Videla") came to power in 1976, the atmosphere in Argentina grew increasingly oppressive. Sosa faced death threats against both her and her family, but refused for many years to leave the country. At a concert in [La Plata](/wiki/La_Plata "La Plata") in 1979, Sosa was searched and arrested on stage, along with all those attending the concert.[[7]](#cite_note-Latin_artist_Mercedes_Sosa_dies-7) Their release came about through international intervention.[[5]](#cite_note-Mercedes_Sosa:_Obituary-5) Banned in her own country, she moved to Paris and then to [Madrid](/wiki/Madrid "Madrid").[[5]](#cite_note-Mercedes_Sosa:_Obituary-5)[[7]](#cite_note-Latin_artist_Mercedes_Sosa_dies-7)
+
+Sosa returned to Argentina from her exile in Europe in 1982,[[7]](#cite_note-Latin_artist_Mercedes_Sosa_dies-7) several months before the military regime collapsed as a result of the [Falklands War](/wiki/Falklands_War "Falklands War"), and gave a series of concerts at the *[Teatro Ópera](/wiki/Teatro_Opera "Teatro Opera")* in Buenos Aires, where she invited many of her younger colleagues to share the stage. A double album of recordings from these performances became an instant best seller. In subsequent years, Sosa continued to tour both in Argentina and abroad, performing in such venues as the [Lincoln Center](/wiki/Lincoln_Center "Lincoln Center") in New York City and the *[Théâtre Mogador](/wiki/Th%C3%A9%C3%A2tre_Mogador "Théâtre Mogador")* in Paris. By then, she was already called America's voice. In poor health for much of the 1990s, she performed a comeback show in Argentina in 1998.[[5]](#cite_note-Mercedes_Sosa:_Obituary-5) In 1994, she played the [Sistine Chapel](/wiki/Sistine_Chapel "Sistine Chapel") in Vatican City.[[3]](#cite_note-Legendary_folk_singer_Mercedes_Sosa_dies_at_74-3) In 2002, she sold out both [Carnegie Hall](/wiki/Carnegie_Hall "Carnegie Hall") in New York and the [Colosseum](/wiki/Colosseum "Colosseum") in Rome in the same year.[[3]](#cite_note-Legendary_folk_singer_Mercedes_Sosa_dies_at_74-3)
+
+[![](//upload.wikimedia.org/wikipedia/commons/thumb/a/a3/Mercedes_Sosa.jpg/250px-Mercedes_Sosa.jpg)](/wiki/File:Mercedes_Sosa.jpg)
+
+Sosa in 1973
+
+A supporter of [Perón](/wiki/Juan_Per%C3%B3n "Juan Perón"), she favored leftist causes throughout her life. She opposed President [Carlos Menem](/wiki/Carlos_Menem "Carlos Menem"), who was in office from 1989 to 1999, and supported the election of [Néstor Kirchner](/wiki/N%C3%A9stor_Kirchner "Néstor Kirchner"), who became president in 2003.[[9]](#cite_note-9)
+Sosa was a [UNESCO Goodwill Ambassador](/wiki/UNESCO_Goodwill_Ambassador "UNESCO Goodwill Ambassador") for Latin America and the Caribbean.[[7]](#cite_note-Latin_artist_Mercedes_Sosa_dies-7)[[10]](#cite_note-10)
+
+In a career spanning four decades, she worked with performers across several genres and generations, folk, opera, pop, rock, including [Martha Argerich](/wiki/Martha_Argerich "Martha Argerich"), [Andrea Bocelli](/wiki/Andrea_Bocelli "Andrea Bocelli"), [David Broza](/wiki/David_Broza "David Broza"), [Franco Battiato](/wiki/Franco_Battiato "Franco Battiato"), [Jaime Roos](/wiki/Jaime_Roos "Jaime Roos"), [Joan Baez](/wiki/Joan_Baez "Joan Baez"), [Francis Cabrel](/wiki/Francis_Cabrel "Francis Cabrel"), [Gal Costa](/wiki/Gal_Costa "Gal Costa"), [Luz Casal](/wiki/Luz_Casal "Luz Casal"), [Lila Downs](/wiki/Lila_Downs "Lila Downs"), [Lucio Dalla](/wiki/Lucio_Dalla "Lucio Dalla"), [Maria Farantouri](/wiki/Maria_Farantouri "Maria Farantouri"), [Lucecita Benitez](/wiki/Lucecita_Benitez "Lucecita Benitez"), [Nilda Fernández](/wiki/Nilda_Fern%C3%A1ndez "Nilda Fernández"), [Charly Garcia](/wiki/Charly_Garcia "Charly Garcia"), [León Gieco](/wiki/Le%C3%B3n_Gieco "León Gieco"), [Gian Marco](/wiki/Gian_Marco "Gian Marco"), [Nana Mouskouri](/wiki/Nana_Mouskouri "Nana Mouskouri"), [Pablo Milanés](/wiki/Pablo_Milan%C3%A9s "Pablo Milanés"), [Holly Near](/wiki/Holly_Near "Holly Near"), [Milton Nascimento](/wiki/Milton_Nascimento "Milton Nascimento"), [Pata Negra](/wiki/Pata_Negra "Pata Negra"), [Fito Páez](/wiki/Fito_P%C3%A1ez "Fito Páez"), [Franco De Vita](/wiki/Franco_De_Vita "Franco De Vita"), [Lourdes Pérez](/wiki/Lourdes_P%C3%A9rez "Lourdes Pérez"), [Luciano Pavarotti](/wiki/Luciano_Pavarotti "Luciano Pavarotti"), [Silvio Rodríguez](/wiki/Silvio_Rodr%C3%ADguez "Silvio Rodríguez"), [Ismael Serrano](/wiki/Ismael_Serrano "Ismael Serrano"), [Shakira](/wiki/Shakira "Shakira"), [Sting](/wiki/Sting_(musician) "Sting (musician)"), [Caetano Veloso](/wiki/Caetano_Veloso "Caetano Veloso"),[[3]](#cite_note-Legendary_folk_singer_Mercedes_Sosa_dies_at_74-3) [Julieta Venegas](/wiki/Julieta_Venegas "Julieta Venegas"), [Gustavo Cerati](/wiki/Gustavo_Cerati "Gustavo Cerati") and [Konstantin Wecker](/wiki/Konstantin_Wecker "Konstantin Wecker")[[7]](#cite_note-Latin_artist_Mercedes_Sosa_dies-7)
+
+Sosa participated in a 1999 production of [Ariel Ramírez](/wiki/Ariel_Ram%C3%ADrez "Ariel Ramírez")'s *Misa Criolla*.[[11]](#cite_note-11) Her song *Balderrama* is featured in the 2008 movie *[Che](/wiki/Che_(2008_film) "Che (2008 film)")*, starring [Benicio del Toro](/wiki/Benicio_del_Toro "Benicio del Toro") as the Argentine [Marxist](/wiki/Marxist "Marxist") revolutionary [Che Guevara](/wiki/Che_Guevara "Che Guevara").[[12]](#cite_note-12)
+
+Sosa was the former co-chair of the [Earth Charter](/wiki/Earth_Charter "Earth Charter") International Commission.
+
+## Awards
+
+She won the Latin Grammy Award for Best Folk Album in 2000 (*Misa Criolla*),[[13]](#cite_note-13) 2003 (*Acústico*),[[14]](#cite_note-14) 2006 (*Corazón Libre*),[[15]](#cite_note-15) 2009 (*[Cantora 1](/wiki/Cantora,_un_Viaje_%C3%8Dntimo "Cantora, un Viaje Íntimo")*, which also won [Best Recording Package](/wiki/Latin_Grammy_Award_for_Best_Recording_Package "Latin Grammy Award for Best Recording Package") and was nominated for [Album of the Year](/wiki/Latin_Grammy_Award_for_Album_of_the_Year "Latin Grammy Award for Album of the Year")),[[16]](#cite_note-16) and 2011 (*Deja La Vida Volar*),[[17]](#cite_note-17) as well as several international awards.
+
+In 1995, [Konex Foundation](/wiki/Konex_Foundation "Konex Foundation") from Argentina granted her the Diamond [Konex Award](/wiki/Konex_Award "Konex Award"), one of the most prestigious awards in Argentina, as the most important personality in the Popular Music of her country in the last decade.[[18]](#cite_note-18)
+
+## Death
+
+[![](//upload.wikimedia.org/wikipedia/commons/thumb/5/56/Funeral_de_Mercedes_Sosa.jpg/250px-Funeral_de_Mercedes_Sosa.jpg)](/wiki/File:Funeral_de_Mercedes_Sosa.jpg)
+
+Mercedes Sosa lying in repose, with her family and President [Cristina Fernández de Kirchner](/wiki/Cristina_Fern%C3%A1ndez_de_Kirchner "Cristina Fernández de Kirchner") viewing
+
+Suffering from recurrent endocrine and respiratory problems in later years, the 74-year-old Sosa was hospitalized in Buenos Aires on 18 September 2009.[[19]](#cite_note-19) She died from [multiple organ failure](/wiki/Multiple_organ_failure "Multiple organ failure") on 4 October 2009, at 5:15 am.[[8]](#cite_note-ap-8) She is survived by one son, Fabián Matus, born of her first marriage.[[5]](#cite_note-Mercedes_Sosa:_Obituary-5)[[20]](#cite_note-Argentine_singer_Mercedes_Sosa,_'voice_of_Latin_America,'_dies_at_74-20) He said: "She lived her 74 years to the fullest. She had done practically everything she wanted, she didn't have any type of barrier or any type of fear that limited her".[[20]](#cite_note-Argentine_singer_Mercedes_Sosa,_'voice_of_Latin_America,'_dies_at_74-20) The hospital expressed its sympathies to her relatives.[[21]](#cite_note-Argentine_folk_legend_Mercedes_Sosa_dead_at_74-21) Her website featured the following: "Her undisputed talent, her honesty and her profound convictions leave a great legacy to future generations".[[22]](#cite_note-Argentine_folk_icon_Sosa_dies_at_74-22)
+
+Her body was placed on display at the [National Congress](/wiki/Argentine_National_Congress "Argentine National Congress") building in Buenos Aires for the public to pay their respects, and President Fernández de Kirchner ordered three days of national mourning.[[20]](#cite_note-Argentine_singer_Mercedes_Sosa,_'voice_of_Latin_America,'_dies_at_74-20)[[23]](#cite_note-23) Thousands had queued by the end of the day.[[22]](#cite_note-Argentine_folk_icon_Sosa_dies_at_74-22) She was cremated on 5 October.[[22]](#cite_note-Argentine_folk_icon_Sosa_dies_at_74-22)[[24]](#cite_note-Argentine_singer_Mercedes_Sosa_dies_at_74-24)
+
+Sosa's obituary in *[The Daily Telegraph](/wiki/The_Daily_Telegraph "The Daily Telegraph")* said she was "an unrivalled interpreter of works by her compatriot, the Argentine [Atahualpa Yupanqui](/wiki/Atahualpa_Yupanqui "Atahualpa Yupanqui"), and Chile's [Violeta Parra](/wiki/Violeta_Parra "Violeta Parra")".[[5]](#cite_note-Mercedes_Sosa:_Obituary-5) Helen Popper of [Reuters](/wiki/Reuters "Reuters") reported her death by saying she "fought South America's dictators with her voice and became a giant of contemporary Latin American music".[[24]](#cite_note-Argentine_singer_Mercedes_Sosa_dies_at_74-24) Sosa received three [Latin Grammy](/wiki/Latin_Grammy "Latin Grammy") nominations for her album, in 2009 . She went on to win Best Folk Album about a month after her death.[[3]](#cite_note-Legendary_folk_singer_Mercedes_Sosa_dies_at_74-3)[[7]](#cite_note-Latin_artist_Mercedes_Sosa_dies-7)
+
+## Tribute
+
+In 2019, she was celebrated by a [Google Doodle](/wiki/Google_Doodle "Google Doodle"). The doodle was showcased in [Argentina](/wiki/Argentina "Argentina"), Chile, [Uruguay](/wiki/Uruguay "Uruguay"), [Paraguay](/wiki/Paraguay "Paraguay"), [Bolivia](/wiki/Bolivia "Bolivia"), [Peru](/wiki/Peru "Peru"), [Ecuador](/wiki/Ecuador "Ecuador"), [Cuba](/wiki/Cuba "Cuba"), [Iceland](/wiki/Iceland "Iceland"), Sweden, [Serbia](/wiki/Serbia "Serbia"), [Greece](/wiki/Greece "Greece"), [Israel](/wiki/Israel "Israel") and [Vietnam](/wiki/Vietnam "Vietnam").[[25]](#cite_note-25)
+
+## Discography
+
+[![](//upload.wikimedia.org/wikipedia/commons/thumb/9/93/Mercedes_sosa.jpg/250px-Mercedes_sosa.jpg)](/wiki/File:Mercedes_sosa.jpg)
+
+Sosa in 2005, with Argentina's then-First Lady (later president from 2007 to 2015), Cristina Fernández de Kirchner
+
+She recorded forty albums.[[3]](#cite_note-Legendary_folk_singer_Mercedes_Sosa_dies_at_74-3)[[7]](#cite_note-Latin_artist_Mercedes_Sosa_dies-7)
+
+### Studio albums
+
+| Year | Album details |
+| --- | --- |
+| 1962 | [La Voz De La Zafra](/wiki/La_Voz_De_La_Zafra "La Voz De La Zafra") |
+| 1965 | Canciones Con Fundamento |
+| 1966 | Hermano |
+| 1966 | Yo No Canto Por Cantar |
+| 1967 | Para Cantarle A Mi Gente |
+| 1968 | Con Sabor A Mercedes Sosa |
+| 1969 | Mujeres Argentinas |
+| 1970 | El Grito De La Tierra |
+| 1970 | Navidad Con Mercedes Sosa |
+| 1971 | [Homenaje a Violeta Parra](/wiki/Homenaje_a_Violeta_Parra "Homenaje a Violeta Parra") |
+| 1972 | Hasta La Victoria |
+| 1972 | Cantata Sudamericana |
+| 1973 | Traigo Un Pueblo En Mi Voz |
+| 1975 | A Que Florezca Mi Pueblo |
+| 1976 | En Dirección Del Viento |
+| 1977 | Mercedes Sosa Interpreta A Atahualpa Yupanqui |
+| 1979 | Serenata Para La Tierra De Uno |
+| 1981 | A Quien Doy / Cuando Me Acuerdo de Mi País |
+| 1982 | Como Un Pájaro Libre |
+| 1983 | Mercedes Sosa |
+| 1984 | ¿Será Posible El Sur? |
+| 1985 | Vengo A Ofrecer Mi Corazón |
+| 1986 | Mercedes Sosa '86 |
+| 1987 | Mercedes Sosa '87 |
+| 1993 | Sino |
+| 1994 | Gestos De Amor |
+| 1996 | Escondido En Mi País |
+| 1997 | Alta Fidelidad (w/[Charly García](/wiki/Charly_Garc%C3%ADa "Charly García")) |
+| 1998 | Al Despertar |
+| 1999 | Misa Criolla |
+| 2005 | Corazón Libre |
+| 2009 | [Cantora 1](/wiki/Cantora,_un_Viaje_%C3%8Dntimo "Cantora, un Viaje Íntimo") (w/various artists) |
+| 2009 | [Cantora 2](/wiki/Cantora,_un_Viaje_%C3%8Dntimo "Cantora, un Viaje Íntimo") (w/various artists) |
+| 2011 | Censurada |
+| 2015 | Lucerito |
+
+### EPs
+
+| Year | EP details |
+| --- | --- |
+| 1975 | Niño De Mañana |
+
+### Live albums
+
+| Year | Album details |
+| --- | --- |
+| 1973 | Si Se Calla El Cantor (with Gloria Martin) |
+| 1980 | Gravado Ao Vivo No Brasil |
+| 1982 | [Mercedes Sosa en Argentina](/wiki/Mercedes_Sosa_en_Argentina "Mercedes Sosa en Argentina") |
+| 1985 | Corazón Americano (with [Milton Nascimento](/wiki/Milton_Nascimento "Milton Nascimento") & [León Gieco](/wiki/Le%C3%B3n_Gieco "León Gieco")) |
+| 1989 | Live in Europe  * Label: Tropical Music/Polygram Argentina |
+| 1991 | De Mí |
+| 2002 | Acústico En Vivo  * Label: Sony Music Argentina |
+| 2003 | Argentina Quiere Cantar (with [Víctor Heredia](/wiki/V%C3%ADctor_Heredia "Víctor Heredia") & [León Gieco](/wiki/Le%C3%B3n_Gieco "León Gieco")) |
+| 2010 | Deja La Vida Volar (En Gira) |
+| 2014 | Angel |
+
+### Compilation albums
+
+| Year | Album details |
+| --- | --- |
+| 1975 | Disco De Oro |
+| 1983 | Recital |
+| 1988 | Amigos Míos |
+| 1993 | 30 Años  * Label: Polygram Argentina |
+| 1995 | Oro |
+| 1997 | The Best Of Mercedes Sosa |
+| 2013 | Siempre En Ti |
+
+## Filmography
+
+* *Güemes, la tierra en armas* (1971)
+* *Argentinísima* (1972)
+* *Esta es mi Argentina* (1974)
+* *Mercedes Sosa, como un pájaro libre* (1983)
+* *Será possible el sur: Mercedes Sosa* (1985)
+* *Historias de Argentina en vivo* (2001)
+
+## Biographies
+
+Mercedes Sosa, La Negra by Rodolfo Braceli (Spanish only)
+
+Mercedes Sosa, La Mami by Fabián Matus (Spanish only)
+
+Mercedes Sosa, The Voice of Hope by Anette Christensen (translated into Spanish and Portuguese)
+
+Mercedes Sosa, More than a Song by Anette Christensen (translated into Spanish, French, Italian, Lithuanian and Portuguese)
+
+## References
+
+## External links