Skip to content

Instantly share code, notes, and snippets.

@peas
Created February 17, 2026 04:01
Show Gist options
  • Select an option

  • Save peas/c78748b8e0019ee048512d54521a9443 to your computer and use it in GitHub Desktop.

Select an option

Save peas/c78748b8e0019ee048512d54521a9443 to your computer and use it in GitHub Desktop.
Pesquisa Genealógica Thompson-Marzagão (fev/2026)

Achados da Pesquisa — Genealogia Thompson-Marzagão

Pesquisa genealógica para a família de Thompson Marinho Marzagão (FSID: LVHS-3FT), nascido em 21/05/1976 em Fortaleza, CE. Árvore com 594 indivíduos, 341 famílias, alcançando até a geração 10.

Pesquisa realizada em fevereiro de 2026 usando FamilySearch API, web scraping, e fontes históricas.


Os grandes achados

1. A família Okamura e o navio Kanagawa-Maru (1929)

Sonia Maria Okamura (1951-2022) aparecia na árvore sem pais. A pesquisa revelou uma história de imigração completa:

  • Pai: Hiroshi Okamura — nascido em 1926 em Yamaguchi-ken, Japão. Chegou ao Brasil com apenas 3 anos no navio Kanagawa-Maru, em 17/09/1929, desembarcando em Santos em 15/11/1929
  • Mãe: Luzia Folador Okamura — nascida em 1928 em Igarapava, SP. Descendente de italianos do Veneto (Treviso/Vicenza)
  • Ambos morreram em 1971, quando Sonia tinha ~20 anos. Circunstâncias desconhecidas — possível acidente

A família inteira viajou no Kanagawa-Maru: o avô Ushinosuke (1889), a avó Hatsuno (1893), e mais duas tias — todos de Yamaguchi-ken. Confirmado via imigrantes.ubik.com.br.

O lado materno de Sonia leva a outra história de imigração: os Folador/Foladore, italianos do Veneto que se estabeleceram na região de Igarapava, na Alta Mogiana paulista — terra de café e de imigrantes.

Fonte: FamilySearch API (person + tree-search), imigrantes.ubik.com.br


2. Os Junqueira Franco: uma família que fundou cidades

José Wilson Junqueira Franco (1917, Colina, SP) é avô na árvore e aparecia sem pais. A pesquisa revelou que ele pertence a uma das famílias mais importantes do interior paulista:

  • Pai: Coronel Antenor Junqueira Franco (1880-1957) — co-fundador de Colina, SP. Tem a avenida principal da cidade com seu nome
  • Mãe: Georgeta de Oliveira (1883-1969) — de Uberaba, MG

A linhagem vai até o patriarca João Francisco Junqueira (1727-1819), que emigrou de São Simão da Junqueira, Braga, Portugal, para Minas Gerais. Seu descendente Francisco Antônio Junqueira estabeleceu a Fazenda Invernada em 1812 — uma propriedade de 70.000 alqueires que originou os municípios de Guaíra, Barretos, Olímpia, Morro Agudo, Monte Azul, Colina, Terra Roxa e mais.

O sobrenome composto "Junqueira Franco" vem de Helena Maria do Espírito Santo (1737), filha de Inácio Franco, que casou com o patriarca. O "Junqueira" vem da paróquia portuguesa; o "Franco" vem da matriarca.

José Wilson casou com Geralda Junqueira Franco (1916-1992) — sua prima em segundo grau. Tiveram 5 filhos.

Existe um livro definitivo: "Família Franco: Genealogia e História" por Gabriel Junqueira Franco (que era do mesmo clã, nascido em 1899).

Fontes: FamilySearch API, genealogiahistoria.com.br, memoriadefamilia.com.br, Câmara Municipal de Colina


3. Os Ximenes de Aragão: do Portugal medieval a Boa Viagem

Júlia Ximenes Aragão (1889-1915) é gen 3 na árvore. Morreu aos 25 anos de complicações de parto, deixando 3 filhos órfãos.

  • Pai: Antônio Ximenes de Aragão (1863-1956) — viveu 93 anos em Boa Viagem, CE. Inspetor escolar e agricultor
  • Mãe: Ana Benvinda Ximenes (~1863-1944)
  • A linhagem paterna sobe até Anacleto Francisco Ximenes de Aragão (1770-1841) e Roberto Francisco Ximenes de Aragão (1803-1867, Sobral)

O sobrenome "Ximenes de Aragão" remonta à nobreza ibérica. No Geneanet há 785 indivíduos registrados com esse sobrenome, com raízes em Beja, Portugal, e ramificações para Pernambuco e Ceará desde o período colonial.

O irmão de Júlia, Luís "Aragão" (1892-1952), foi o primeiro prefeito eleito de Boa Viagem (1926-1930). Outro irmão, Aluísio (1896-1984), foi coletor de impostos estaduais.

O marido de Júlia, Manuel Araújo Marinho, casou-se novamente apenas 2 dias antes (ou depois?) do óbito dela — há um conflito de datas nos registros que precisa ser verificado.

Fontes: FamilySearch API, historiadeboaviagem.com.br (offline, parcial no Scribd), Geneanet, Geneall.net


4. Anna de Oliveira Maciel: a mais antiga da árvore (~1700)

Na geração 10, Anna de Oliveira Maciel (FSID: LV5G-H12) é a pessoa mais antiga identificável na árvore Thompson-Marzagão. Nascida por volta de 1700 em Goiana, Pernambuco, ela aparece em fontes publicadas de peso:

  • Nobiliarchia Pernambucana — obra clássica de genealogia colonial
  • Siará Grande — referência para famílias do Ceará colonial

São 12 fontes no FamilySearch e 8 filhos documentados. Há uma disputa sobre sua ancestralidade no FamilySearch relacionada a certificações sefarditas falsas — tema sensível que precisa de verificação cuidadosa.

Fonte: FamilySearch API, fontes bibliográficas coloniais


5. Jaguari não é Carangola — é Camanducaia

Na pesquisa do casal José Hygino de Carvalho + Maria Joanna da Conceição (avós maternos de Dalma Russo), descobrimos que o "Jaguari, MG" do FamilySearch não é Carangola (como geralmente se assume), mas sim Camanducaia, MG — na divisa com São Paulo, perto de Extrema e Bragança Paulista. As coordenadas do FamilySearch (lat -22.754, lon -46.1388) confirmam.

Isso muda completamente o contexto geográfico dessa família. A filha do casal, Rita Maria de Carvalho, morreu em Bragança Paulista (1985) — coerente com Camanducaia, não com Carangola (que fica a 400km de distância).

Descobrimos também um terceiro filho: Julio Hygino de Carvalho, morto em 16/10/1928 em Cambuí, com data exata — o melhor lead para encontrar os pais nos registros civis.

Fonte: FamilySearch API (coordenadas geográficas), registros civis


6. Erros encontrados no FamilySearch

  • Anna Gonçalves da Purificação (GBP8-W8J): local de nascimento registrado como "Madagascar". Na verdade é Bispado de Mariana, MG — provavelmente confusão do indexador com "Mariana"
  • João Pereira de Mattos (GK7P-9YW): casou em 1774 e teria morrido em 1868 — 94+ anos. Provavelmente a data de morte pertence a um descendente homônimo
  • Júlia Ximenes Aragão: segundo casamento do marido registrado 2 dias antes do óbito dela. Uma das datas está errada

Distribuição geográfica da árvore

Região Pessoas Observações
Ceará 197 Ramo principal (Thompson, Ximenes Aragão, Araújo Marinho)
Minas Gerais 188 Ramos antigos (gen 7-10), Camanducaia, Uberaba
São Paulo 146 Junqueira Franco (Colina), Russo/Folador (Bragança), Okamura (Igarapava)
Pernambuco 43 Ramos coloniais (Oliveira Maciel, gen 10)
Japão ~7 Família Okamura (Yamaguchi-ken)
Itália ~10 Russo/Citrangulo (Camerota, Salerno), Folador (Veneto)
Portugal vários Junqueira (Braga), Ximenes de Aragão (Beja), Lambert (Lisboa)
Líbano 1 Leila Khalidy (Beirute) — sem dados

Lição metodológica

O GEDCOM exportado do FamilySearch estava desatualizado. Dos 13 "brick walls" identificados na análise inicial, apenas 5 eram reais. Os outros 8 já tinham pais vinculados no FamilySearch — bastava navegar a árvore.

Regra de ouro: antes de pesquisar qualquer brick wall, rodar fs.py ancestry {FSID} --generations 2 para verificar se os pais já existem no FamilySearch.


Pesquisa realizada em 17/02/2026 usando FamilySearch API, web scraping, e fontes históricas. Arquivos detalhados por pessoa em data/research/.

A Família Thompson-Marzagão: onde o sertão encontra o mar do Japão

Uma narrativa genealógica baseada em pesquisa documental e fontes históricas.


O menino de Fortaleza e suas sete origens

Thompson Marinho Marzagão nasceu em 21 de maio de 1976 em Fortaleza, Ceará. O nome é inglês, o sobrenome intermediário é português-cearense, o último é italiano-paulista. Mas a árvore que sustenta esse nome é ainda mais improvável do que ele sugere: são pelo menos sete linhagens distintas — cearense, mineira, paulista, japonesa, italiana, portuguesa e libanesa — que convergiram ao longo de três séculos para produzir uma única pessoa.

Esta é a história de como isso aconteceu.


O coronel que fundou uma cidade

Pelo lado paterno da avó, a árvore leva a Colina, uma pequena cidade no noroeste de São Paulo que deve sua existência à família Junqueira Franco.

O patriarca remoto é João Francisco Junqueira (1727-1819), que emigrou de São Simão da Junqueira, em Braga, para Minas Gerais. Casou-se com Helena Maria do Espírito Santo, filha de Inácio Franco — e dessa união nasceu o sobrenome composto que marcaria a região por dois séculos: Junqueira vem da paróquia portuguesa, Franco vem da matriarca.

O neto, Francisco Antônio Junqueira, cruzou a divisa de Minas para São Paulo por volta de 1812 e estabeleceu a Fazenda Invernada — uma propriedade descomunal de 70.000 alqueires (cerca de 170.000 hectares) que originou mais de uma dúzia de municípios. Colina foi um deles.

Em 1926, quando Colina se emancipou, o primeiro prefeito foi um Junqueira Franco. A avenida principal da cidade leva o nome de outro: Coronel Antenor Junqueira Franco (1880-1957). Antenor é o bisavô de Thompson pelo lado Junqueira.

Seu filho José Wilson Junqueira Franco (1917) casou-se com Geralda — prima em segundo grau, como era comum na família. Tiveram cinco filhos. José Wilson morreu em Itapura, SP, em data desconhecida.

Fontes: FamilySearch, Câmara Municipal de Colina, genealogiahistoria.com.br, livro "Família Franco: Genealogia e História" por Gabriel Junqueira Franco


De Yamaguchi-ken ao cafezal de Igarapava

A história mais surpreendente da árvore talvez seja a de Sonia Maria Okamura (1951-2022), que aparecia no FamilySearch como uma folha solta — sem pais, sem contexto.

A pesquisa revelou que seu pai, Hiroshi Okamura, nasceu em 1926 em Yamaguchi-ken, no sul do Japão. Tinha três anos quando embarcou com a família inteira no navio Kanagawa-Maru, em setembro de 1929. Chegaram a Santos em novembro. Destino: as fazendas de café do interior paulista.

A bordo vinham o avô Ushinosuke (1889), a avó Hatsuno (1893), as tias Tomiko e Shigueko, e provavelmente alguns tios. Todos de Yamaguchi-ken. A família se estabeleceu na região da Alta Mogiana — terra de café e de imigrantes.

Em 1944, aos 18 anos, Hiroshi casou-se com Luzia Folador — brasileira de Igarapava, filha de italianos do Veneto. É um casamento que cruza dois oceanos: Japão e Itália, encontrando-se num cartório do interior de São Paulo.

Sonia nasceu em 1951 em Igarapava. Em 1971, algo terrível aconteceu: ambos os pais morreram no mesmo ano. Sonia tinha vinte anos. As circunstâncias permanecem desconhecidas — pode ter sido um acidente. Ela seguiu a vida, tornou-se psicóloga em São Paulo, e faleceu em 2022.

Fontes: FamilySearch API, imigrantes.ubik.com.br, registros de imigração japonesa


A jovem mãe de Boa Viagem

Júlia Ximenes Aragão nasceu em 7 de dezembro de 1889 em Boa Viagem, no sertão cearense. Filha de Antônio Ximenes de Aragão — que viveria até os 93 anos — e de Ana Benvinda Ximenes.

O sobrenome remonta à nobreza ibérica. Os Ximenes de Aragão chegaram ao Ceará no período colonial, vindos de Beja, Portugal, passando por Pernambuco. No Geneanet há 785 indivíduos registrados com esse sobrenome.

Júlia casou-se com Manuel Araújo Marinho, que se tornaria prefeito de Boa Viagem. Tiveram três filhos em rápida sucessão: Solon (1911), Manoel (1913) e Olga (1914). Em 23 de julho de 1915, aos 25 anos, Júlia morreu de complicações do parto — provavelmente do nascimento de Olga ou de uma gravidez que não sobreviveu.

Três crianças ficaram órfãs de mãe. Manuel casou-se novamente — os registros dizem que dois dias antes do óbito de Júlia, o que é certamente um erro de transcrição.

O irmão de Júlia, Luís "Aragão", se tornaria o primeiro prefeito eleito de Boa Viagem em 1926. Outro irmão, Aluísio, foi coletor de impostos estaduais e viveu até 1984. A árvore paterna sobe até Anacleto Francisco Ximenes de Aragão (1770-1841), seis gerações antes de Thompson.

Fontes: FamilySearch, historiadeboaviagem.com.br (offline, parcial no Scribd), Geneanet


Os italianos de Camerota e os mineiros de Camanducaia

A avó paterna de Thompson, Dalma Russo (1932, Bragança Paulista), descende de duas linhagens que a pesquisa mostrou serem mais profundas do que o GEDCOM sugeria.

Pelo lado paterno, seu avô Vincenzo Antonio Russo (1872-1956) e sua avó Antonia Citrangulo (1879-1949) são da região de Camerota, na província de Salerno, Campania. É o ramo italiano da árvore — ainda relativamente raso, com potencial para expansão nos registros civis italianos digitalizados no Antenati e no FamilySearch (coleção 1935404).

Pelo lado materno, os avós de Dalma são José Hygino de Carvalho e Maria Joanna da Conceição, de Jaguari, MG. Aqui uma descoberta importante: "Jaguari" não é Carangola (como se assume), mas Camanducaia — uma cidade na divisa com São Paulo, perto de Extrema e Bragança Paulista. As coordenadas do FamilySearch confirmam. "Da Conceição" não é sobrenome, mas nome devocional — a padroeira de Camanducaia é Nossa Senhora da Conceição.

O casal teve pelo menos três filhos, incluindo Julio Hygino de Carvalho, que morreu em 16 de outubro de 1928 em Cambuí, com data exata registrada. Esse é o melhor caminho para encontrar os pais nos registros civis.

Fontes: FamilySearch API (coordenadas geográficas), registros civis de Camanducaia e Cambuí


As pontas soltas

Toda genealogia tem seus mistérios não resolvidos. Na árvore Thompson-Marzagão, os principais são:

Leila Khalidy (1945, Beirute) — casou-se com alguém da família, mas seus pais e sua história no Líbano permanecem completamente desconhecidos. Registros libaneses são difíceis de acessar sem contato familiar direto.

Martini Jose De Brito Lambert — aparece como segundo marido de Francisca Amelia Furquim, viúva de Maximiano. Sem filhos, sem dados. O sobrenome Lambert vem de Zeferino Jose de Brito Lambert (1774-1840, Lisboa), mas Martini não aparece entre os filhos documentados do Capitão Antônio, pai de Maximiano. Hipótese: sobrinho ou primo que casou com a viúva após 1924.

José Queiroz da Cunha e Silva e Maria das Mercês de Queiroz — casal de Quixadá, CE, gen 4. Nomes comuns, poucos registros. O caminho mais promissor é o batismo de sua filha Maria Gabrielina (1897, Quixadá), que listaria avós.

36 pessoas desconectadas — existem no GEDCOM mas não se ligam à raiz. Podem ser ramos colaterais, erros de importação, ou pessoas adicionadas sem conexão.


O que aprendemos

A árvore Thompson-Marzagão é um mapa do Brasil: sertão cearense, fazendas paulistas, imigração japonesa e italiana, raízes portuguesas coloniais, e um toque libanês que resiste à pesquisa. São pelo menos dez gerações documentadas, alcançando o século XVIII em vários ramos.

A pesquisa de fevereiro de 2026 resolveu ou avançou significativamente vários brick walls — mas principalmente revelou que o GEDCOM exportado estava desatualizado e que muitas "lacunas" já estavam preenchidas no FamilySearch. A lição: antes de pesquisar, verificar.

Os próximos passos são mais difíceis: registros civis que precisam ser folheados imagem por imagem, cartórios que precisam ser contatados, e um site inestimável sobre Boa Viagem que está fora do ar. A genealogia nunca termina — só pausa.


PIDs verificados: Thompson (LVHS-3FT), José Wilson (GFCN-PS3), Antenor (K6HM-JNK), Sonia (GXC3-7VC), Hiroshi (GXCS-B4T), Luzia (GXC3-QHD), Ushinosuke (GXCW-DHR), Júlia (LKGR-3JD), Antônio Ximenes (LKL1-1CV), Ana Benvinda (LK54-R63), Dalma (GBR2-5MJ), Vincenzo Russo (LBVG-TQG), José Hygino (G9X5-7NG), Maria Joanna (KZJH-3R3), Anna de Oliveira Maciel (LV5G-H12).

Pesquisa: Paulo Silveira, fevereiro de 2026. Fontes completas nos arquivos individuais em data/research/.

Próximos Passos — Pesquisa Genealógica Thompson-Marzagão

Atualizado em 17/02/2026 após rodada de pesquisa com FamilySearch API.


Ação imediata: Re-exportar o GEDCOM

O GEDCOM local (data/original.ged) está desatualizado — muitos vínculos já existem no FamilySearch mas não no arquivo. Antes de qualquer outra pesquisa:

  1. Re-exportar GEDCOM do FamilySearch (raiz: LVHS-3FT, Thompson Marinho Marzagão)
  2. Rodar o parser → atualizar data/tree.yaml
  3. Regenerar data/analysis.md
  4. Verificar se surgem novos brick walls reais

Brick walls reais (confirmados sem pais no FS)

Casal de Camanducaia, MG — José Hygino + Maria Joanna

Quem FSID Dados
José Hygino de Carvalho G9X5-7NG Camanducaia (antiga Jaguari), MG. Sem datas
Maria Joanna da Conceição KZJH-3R3 Idem. "Conceição" é devocional, não sobrenome

Estratégia (em ordem de eficiência):

  1. Localizar óbito de Julio Hygino de Carvalho (16/10/1928, Cambuí, MG) — data exata, vai listar pais. FamilySearch pode ter imagens
  2. Folhear registros paroquiais de Camanducaia — FamilySearch cat. 327733, Imaculada Conceição, 1776-1924
  3. Folhear registros civis de Camanducaia — FamilySearch cat. 519424, 1889-1932
  4. Buscar casamento do casal em Camanducaia (antes de 1894, quando nasce a filha mais velha)
  5. Contatar Cartório de Registro Civil de Camanducaia ou Cambuí

Casal de Quixadá, CE — José Queiroz + Maria das Mercês

Quem FSID Dados
José Queiroz da Cunha e Silva G9J5-JPF Quixadá, CE. Nome alt: "José Luiz da Cunha". ~1865-1877
Maria das Mercês de Queiroz G9J5-VZJ Quixadá, CE. "Queiroz" é nome de solteira

Estratégia:

  1. Buscar batismo de Maria Gabrielina de Queiroz (1897, Quixadá) — certidão lista avós
  2. Buscar casamento do casal em Quixadá (antes de 1897)
  3. Esperar historiadeboaviagem.com.br voltar ao ar — fonte riquíssima para esse ramo
  4. Ler PDFs de Boanerges Facó na Academia Cearense de Letras sobre família Queiroz
  5. Buscar registros de Quixadá no FamilySearch (paroquiais e civis)

Martini Jose De Brito Lambert

Quem FSID Dados
Martini Jose De Brito Lambert P9CD-F9J 2º marido de Francisca Amelia Furquim. Sem filhos

Estratégia:

  1. Buscar casamento de Martini com Francisca Amelia Furquim em Bragança Paulista (pós-1924, após morte de Maximiano)
  2. Buscar parentesco com Maximiano Jose de Brito Lambert (1856-1924) — provavelmente primo ou sobrinho
  3. Linhagem Lambert documentada: Zeferino (1774, Lisboa) → Capitão Antônio → Maximiano. Martini é de outro ramo
  4. Verificar registro civil ark:/61903/1:1:6YG8-8WCW (fonte já vinculada)

Pessoas vivas com acesso bloqueado (403)

A API do FamilySearch bloqueia acesso a perfis de pessoas vivas não vinculadas ao dono do token. Precisa pedir ao Thompson:

Quem FSID O que precisa
Rosana Cristina F. de Albuquerque GXVW-SP3 Nomes dos pais, local de nascimento completo
Maria Eugênia Pinto GQ98-TT6 Qualquer dado — sem data/local no GEDCOM
Leila Khalidy GF6F-KDR Dados dos pais no Líbano. Difícil sem info familiar

Opções:

  • Thompson exportar esses dados manualmente do FamilySearch
  • Thompson adicionar o pesquisador como colaborador na árvore
  • Thompson fornecer os dados via conversa

Correções no FamilySearch

Correção FSID Detalhe
Birthplace errado GBP8-W8J "Madagascar" → Bispado de Mariana, MG
Data de morte suspeita GK7P-9YW João Pereira de Mattos: morte 1868 para quem casou em 1774. Provavelmente homônimo
Conflito de datas LKGR-3JD 2º casamento do marido (21/07/1915) vs óbito de Júlia (23/07/1915)

Vinculações pendentes no FamilySearch

Quem vincular Como filho(a) de Confiança Pré-requisito
Sonia Okamura (GXC3-7VC) Hiroshi (GXCS-B4T) + Luzia (GXC3-QHD) Alta Confirmar com registro civil (ARK NZ4L-6YP)
Julio Hygino de Carvalho (KZFL-SF8) José Hygino (G9X5-7NG) + Maria Joanna (KZJH-3R3) Média Verificar registro de óbito

Expandir ramo italiano (Dalma Russo)

Agora que os avós de Dalma estão confirmados, o foco é subir o ramo italiano:

Quem FSID Estratégia
Vincenzo Antonio Russo (1872-1956) LBVG-TQG Antenati + FamilySearch coll. 1935404 (Camerota)
Antonia Citrangulo (1879-1949) KZ5H-XB6 Idem
Francesco Giuliani (1874) L1V3-MKZ Antenati, portais italianos
Andrea Russo LBPS-MNK Sem dados — precisa de registros italianos
Silvestre Pacello LBPS-WLZ Idem

Ferramentas: Antenati (antenati.cultura.gov.it) — precisa Playwright, bloqueia WebFetch. FamilySearch coleção 1935404 (Camerota civil records 1806-1949).


OCR e imagens

  • 6 imagens não indexadas de Luísa Maria de Jesus (LHDV-B35) — registros paroquiais do Ceará. OCR com Tesseract (por+eng) pode revelar data de nascimento
  • Registro civil de Igarapava (cat. 2656379) — imagens do nascimento de Sonia Okamura (agosto 1951). Confirma pais

Pesquisas manuais (não automatizáveis)

Estas precisam de ação humana:

  1. Contatar Cartório de Cambuí, MG — pedir certidão de óbito de Julio Hygino de Carvalho (16/10/1928)
  2. Contatar Cartório de Camanducaia, MG — pedir certidão de casamento de José Hygino + Maria Joanna (~1890)
  3. Contatar Cartório de Quixadá, CE — pedir certidão de batismo/nascimento de Maria Gabrielina de Queiroz (~1897)
  4. Comprar livro "Família Franco: Genealogia e História" por Gabriel Junqueira Franco — Amazon
  5. Acessar Wayback Machine para historiadeboaviagem.com.br — conteúdo parcial já disponível no Scribd
  6. Pedir ao Thompson dados das 3 pessoas com acesso 403
  7. Folhear imagens no FamilySearch (login necessário) — registros de Camanducaia, Cambuí, Igarapava, Quixadá

Prioridade por impacto

Prio Ação Impacto
1 Re-exportar GEDCOM Atualiza toda a base de dados
2 Óbito de Julio em Cambuí Quebra brick wall Carvalho/Conceição
3 Batismo de Maria Gabrielina em Quixadá Quebra brick wall Queiroz/Cunha
4 Pedir dados das 3 pessoas 403 ao Thompson Desbloqueia 3 ramos
5 Vincular Sonia + pais no FS Consolida pesquisa Okamura
6 Expandir ramo italiano Aprofunda ramo mais raso
7 Corrigir erros no FS Limpeza de dados

Guia Claude Code — Pesquisa Genealógica

Este guia permite que o Thompson (ou qualquer pesquisador) configure um ambiente de pesquisa genealógica usando o Claude Code com acesso ao FamilySearch e outras fontes.


Setup inicial

1. Estrutura de diretórios

genealogia-thompson/
├── CLAUDE.md          # Instruções do projeto (este arquivo adaptado)
├── TODO.md            # Próximos passos de pesquisa
├── data/
│   ├── original.ged   # GEDCOM exportado do FamilySearch
│   ├── tree.yaml      # Árvore parseada (gerado pelo parser)
│   ├── analysis.md    # Análise de lacunas (gerado)
│   └── research/      # Um .md por pessoa pesquisada
│       ├── nome-sobrenome.md
│       └── fs-person-XXXX-XXX.json  # Cache da API
├── scripts/
│   └── parse-gedcom.ts  # Parser GEDCOM → YAML
└── documents/         # Certidões, fotos, OCR (opcional)

2. Scripts do FamilySearch (instalar de ~/genealogia/)

Os scripts essenciais para pesquisa via API:

Script O que faz Uso
fs.py CLI unificado FamilySearch Token, ancestry, search, person, changelog
fs_common.py Utilitários compartilhados Token loading, API calls
familysearch_api.py REST API FamilySearch Historical records search

Instalação: copiar fs.py, fs_common.py, e familysearch_api.py para o diretório do projeto.

3. Autenticação no FamilySearch

# 1. Fazer login em familysearch.org no browser
# 2. Abrir DevTools (F12) → Application → Cookies
# 3. Copiar o valor do cookie "fssessionid"
# 4. Salvar no projeto:
python3 fs.py token --set-session "SEU_FSSESSIONID_AQUI"

O token expira em ~24h. Funciona como Bearer token para a API REST (tree + records). Não precisa de OAuth2.


Comandos essenciais

Buscar pessoa por FSID

python3 fs.py person LVHS-3FT

Retorna: nome, datas, locais, fatos, contribuidores. Salva JSON em playwright-state/results/.

Ancestry (subir gerações)

python3 fs.py ancestry LVHS-3FT --generations 4

Retorna: árvore de ancestrais até N gerações. Use isso ANTES de pesquisar qualquer brick wall — pode ser que os pais já estejam vinculados.

Buscar na árvore

python3 fs.py tree-search --surname "Thompson" --place "Fortaleza"
python3 fs.py tree-search --surname "Okamura" --place "Igarapava" --given "Sonia"

Buscar registros históricos

python3 fs.py search --surname "Russo" --collection 1935404
python3 fs.py search --surname "Carvalho" --place "Camanducaia" --given "Jose"

Changelog (quem editou)

python3 fs.py changelog LVHS-3FT

Regras de ouro para o Claude Code

Colocar no CLAUDE.md do projeto:

## Regras de Pesquisa Genealógica

1. **SEMPRE verificar antes de pesquisar**: rodar `fs.py ancestry {FSID} --generations 2`
   antes de investir tempo em qualquer brick wall. O GEDCOM pode estar desatualizado.

2. **NÃO fazer N+1 requests**: se precisa dados de 10 pessoas, usar batch ou loop,
   não fazer 10 pesquisas separadas.

3. **Citar fontes sempre**: link, acervo, página, data de acesso.

4. **Um arquivo por pessoa** em `data/research/nome-sobrenome.md`.

5. **Salvar JSONs da API** para referência futura.

6. **Registros de pessoas vivas**: API retorna 403. Precisa de acesso direto
   ou dados fornecidos pelo dono da árvore.

Formato YAML por pessoa

Para registros estruturados (opcional, mas útil para automação):

id: nome-sobrenome
name: Nome Completo
alt_names: [Variação 1, Variação 2]
familysearch_id: XXXX-XXX

birth:
  date: "YYYY-MM-DD"
  place: "Cidade, Estado, País"
  confidence: high|medium|low
  sources:
    - file: "sobrenome/documento.jpg"
    - url: "https://..."

death:
  date: "YYYY-MM-DD"
  place: "Cidade, Estado"

parents:
  father: {name: "Nome", id: id-do-pai, familysearch_id: XXXX-XXX}
  mother: {name: "Nome", id: id-da-mae, familysearch_id: XXXX-XXX}

marriage:
  spouse: id-do-conjuge
  date: "YYYY-MM-DD"
  place: "Local"

children:
  - id-do-filho

notes:
  - "Observação livre"

flags:
  - NEEDS_REVIEW: "O que precisa ser revisado"
  - NEEDS_RESEARCH: "O que precisa ser pesquisado"

status: needs_review|needs_research|done

Notas de pesquisa (journaling)

Manter um arquivo data/research/nome-sobrenome.md para cada pessoa pesquisada. Formato sugerido:

# Nome Completo (gen X) — FSID

- **Nascimento**: data, local
- **Óbito**: data, local
- **Status**: [resolvido|em andamento|brick wall]

## O que foi encontrado

### Via FamilySearch API
- Dados extraídos...

### Via web
- Fontes consultadas...

## Hipóteses
- Hipótese A: ...
- Hipótese B: ...

## Próximos passos
1. ...
2. ...

## Fontes
- [Link 1](url)
- [Link 2](url)

---
*Pesquisa realizada em YYYY-MM-DD*

Fontes úteis por tipo de pesquisa

Brasil — geral

Fonte URL O que tem Acesso
FamilySearch familysearch.org Registros paroquiais, censos, civis Grátis (login)
Hemeroteca Digital memoria.bn.gov.br Jornais históricos Grátis
Find A Grave findagrave.com Cemitérios Grátis
Arquivo Nacional an.gov.br Imigração, naturalização Grátis
MyHeritage myheritage.com Árvores compartilhadas Paywall

Ceará

Fonte URL Notas
historiadeboaviagem.com.br (offline, Scribd) Gold mine para Boa Viagem
familiaquixada.com.br Conexões cearenses
geneall.net Genealogia lusófona

São Paulo — imigração

Fonte URL Notas
imigrantes.ubik.com.br Imigração japonesa — excelente
Museu da Imigração SP museudaimigracao.org.br Listas de embarque (italianos)
Hospedaria de Imigrantes Registros 1882-1973

Itália

Fonte URL Notas
Antenati antenati.cultura.gov.it Registros civis 1809+. Bloqueia scraping — usar Playwright
FamilySearch coll. 1935404 Camerota civil records 1806-1949
Cognomix.it Distribuição de sobrenomes

Portugal

Fonte URL Notas
DigitArq digitarq.arquivos.pt Batismos, passaportes
Tombo.pt Catálogo por paróquia

Distribuição de sobrenomes

Fonte URL Uso
Forebears.io forebears.io Distribuição mundial
Cognomix.it cognomix.it Distribuição na Itália

Dica: pesquisar distribuição do sobrenome ANTES de pesquisar registros. Ajuda a identificar a região de origem.


Técnicas que funcionam

  1. Web scraping de blogs locais > FamilySearch para famílias brasileiras
  2. Obituários (Legacy.com, jornais locais) — listam nomes dos pais/filhos
  3. OCR de certidões — Tesseract (por+eng) para impressos, EasyOCR para manuscritos
  4. Geneanet para encontrar outros pesquisadores da mesma família
  5. Sobrenomes abrasileirados — Ferrari→Ferreira, D'Alessandro→Alexandre
  6. Registros de casamento são melhores que batismo — listam pais de AMBOS os noivos

Coisas que o Claude Code NÃO consegue fazer sozinho

  • Folhear imagens no FamilySearch — registros não indexados precisam de olho humano
  • Resolver hCaptcha — Playwright headed com solve manual 1x, depois cacheia sessão
  • Acessar Antenati — bloqueia requests automatizados (403), precisa Playwright
  • Acessar perfis de pessoas vivas — FamilySearch retorna 403 mesmo com token válido
  • Contatar cartórios — precisam de email, telefone, ou visita presencial
  • Interpretar manuscritos — OCR falha em documentos antigos, precisa de paleografia humana

Workflow recomendado

1. Exportar GEDCOM → parsear → analisar lacunas
2. Para cada brick wall:
   a. fs.py ancestry {FSID} → verificar se pais existem
   b. Se não existem: fs.py person → fs.py search → web search
   c. Documentar em data/research/nome.md
   d. Se encontrou: vincular no FamilySearch
3. Expandir ramos rasos (italiano, japonês, libanês)
4. Corrigir erros encontrados no FamilySearch
5. Repetir

Guia criado em 17/02/2026 com base na experiência do projeto ~/genealogia/ (pesquisa genealógica de Paulo Silveira).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment